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Notational Conventions 

This manual uses these conventions: 

• All numbers are decimal unless otherwise stated. 

• Bit 0 is the low-order bit unless otherwise stated. 

• Computer output and input is printed like this. 

• System call names and command names appear in bold. 

Pathnames are given by logical name (such as :config:) and forward slash (/), as 
seen from the iRMX® Human Interface (HI) prompt. Logical names correspond to 
the following DOS pathnames: 

Logical Name DOS iRMX OS 

:rmx: \rmx386\ :sd:rmx386/ 

:config: \rmx386\config\ :sd:rmx386/config 

See also: Logical names, Command Reference 

Default file structure. Installation and Startup 

iRMX system calls use prefixes to designate functions or OS layers: 

• When referring to the system calls that begin with rq, this manual uses a 
shorthand notation and omits the prefix. For example, s_create_file means 
rq_s_create_file. 

• When referring to system calls that begin with rqe, this manual spells out the 
complete names, including the rqe characters, for example rqe_create_iojob. 


iS> Note 

Notes indicate important information. 

A CAUTION 

Cautions indicate situations which may damage hardware or data. 
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Overview of 
System Configuration 


Introduction 

This manual describes how to configure the iRMX® III, iRMX for Windows, and 
iRMX for PCs operating systems. Some configuration processes, such as adding 
users and terminals, are the same for all three operating systems (OS). Other kinds 
of configurations may be different from one OS to the next: 

• You can configure any of the OSs with the Interactive Configuration Utility 
(ICU). You can configure almost every aspect of the OS with the ICU, 
including support for a variety of hardware components and bus architectures. 
You can also use the ICU to build your application into the bootable OS. 

See also: ICU User's Guide and Quick Reference', 

Programming Techniques and Tools 

• iRMX for Windows is preconfigured to work on PC-compatible platforms with 
DOS and Windows. iRMX for PCs also runs on PC-compatible platforms, but 
without DOS and Windows interoperability. You can change the rmx.ini 
configuration file to fine-tune these OSs without using the ICU; changes take 
effect during load-time. Each OS layer reads entries from rmx.ini during 
initialization, overriding preconfigured values. 

• For all versions of the OS you can also do run-time configuration with the 
sysload command. In iRMX for Windows and iRMX for PCs, the main action 
of the :config:r?init file is to submit the :config:loadinfo file, containing 
sysload commands for loadable jobs and drivers. 

Default Configuration of the iRMX® III OS 

The iRMX OS installation provides ICU definition files {:icu:*.bck) that define the 
default configuration for various hardware platforms. Use one of these files as a 
starting point in the ICU for your custom configuration. 

See also: List of .bck definition files, ICU User’s Guide and Quick Reference 
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Default Configuration of IRMX for Windows and iRMX for PCs 

When you install iRMX for Windows or iRMX for PCs, an installation script 
guides you through the initial configuration of the system. You are asked whether 
to install a run-time only version or a complete system including development 
tools. You are also queried for various network options. 

See also: Installation and Startup 

Reasons to Change the Default Configuration 

Here are some reasons for changing the default configuration: 

Users There are two users defined for the system: Super and World. The 

Super user is the system administrator, with access to all system files 
and devices. The World user has restricted access to files installed on 
an iRMX file system (all users have full access to files on a DOS file 
system). If more than one person uses the system, create a separate 
user logon for each. In the iRMX file system you can protect files 
and/or directories for each user. Even on a single-user system, you 
may want to log on for general work as a different user than World or 
Super, to keep your work distinct from these default users. Use the 
Super logon only for system administration duties. 

Terminals A set of terminal devices and types is defined by the OS. In iRMX for 
Windows and iRMX for PCs, only one terminal is initialized by 
default: the main console device, d_cons (DOS console). When 
configuring terminals, initialize other devices or change keyboard and 
screen characteristics to match your preferences. For example, you 
can: 

• Specify a different terminal type for a serial port 

• Define a new console device, with different keyboard 
characteristics than the default 

• Set up the COMl and COM2 ports for use with a terminal 

• Specify a terminal driver made available by a loadable device 
driver 

• Associate a terminal with a particular user 

See also: Terminal definitions. Chapter 2 

Network A set of jobs, either loadable or ICU-configurable, provides 
networking. You can choose from a variety of network jobs, 
depending on your system architecture. 
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Loadable Jobs and Drivers 

Using loadable jobs and drivers enhances iRMX for Windows and 
iRMX for PCs during run-time, while setting up the OS to work with 
your hardware configuration. You can add your own application as 
one or more loadable jobs. Non-standard hardware is supported by 
loading custom device drivers. The OS treats loaded jobs and drivers 
as child jobs of the HI layer. 

See also: Loadable jobs and drivers, Chapters 3 and 4, in this 

manual 

System jobs. Chapter 6, in this manual. 

Driver Programming Concepts 

Load-time The rmx.ini file contains entries that match settings preconfigured into 
iRMX for PCs and iRMX for Windows. Modify the existing rmx.ini 
entries to fine-tune your configuration. 

ICU-configurable Jobs 

In any of the OSs, use jobs and drivers in loadable form during the 
debug phase, then configure them into the OS as system jobs using the 
ICU, along with layers of the OS. 

Soft-Scope You can use the Soft-Scope debugger after configuring the C library. 
See also: Chapter 8 

Configuration Methods 

To configure an iRMX system, run the ICU with a definition file that matches your 
hardware. The definition file contains parameters that define the current 
configuration. The ICU presents these parameters one screen at a time. Modify 
the system by changing parameter values. Then use the ICU to generate a new 
bootable OS. 

See also: ICU User's Guide and Quick Reference 

In iRMX for Windows and iRMX for PCs, you can configure the OS by editing 
configuration files and rebooting the system. If you install iRMX for Windows on 
the DOS file system, you have the choice of editing the files in DOS (you may 
have to change the attributes of hidden files), or in the iRMX OS. Use a text editor 
such as DOS EDIT, Windows Notepad, or AEDIT (supplied with the iRMX OS). 

If you use a word processor (e.g., WordPerfect), be sure to save the files as DOS 
text. You can also use the ICU to generate a custom system or modify an existing 
definition file for iRMX for Windows or iRMX for PCs. 
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The System Administrator 

You become the system administrator by logging on as Super or by invoking the 
super command after logging on as another user. The default password is passme. 
The Super user has user ID 0, providing all access rights to all files on the system. 

See also: Logging on, Installation and Startup 

As system administrator you can change the Super user password with the 
password command. You also have the right to: 

• Change the access rights to any file. 

• Read all data files and list all directories. 

• Detach devices attached by any user. 

• Delete any user from the system. 

• Invoke the shutdown command. 

The Named file driver maintains files installed on an iRMX file system. If you 
install on an iRMX file system, configuration files are restricted to access by the 
Super user only. 

You edit configuration files from the iRMX prompt while logged on as Super. In 
three cases, you must use only an iRMX utility to modify a configuration file 
(don’t edit the file directly), because encrypted passwords are used: 

• When adding or removing users, use the password command. 

• When configuring subnetworks within an OpenNET network, use the modcdf 
utility. 

• When creating the ccinfo file used by the Remote Boot Server job, use the bcl 
utility. 
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Configuration Files 

Table 1-1 lists the iRMX configuration files, which are in the :config: directory. In 
iRMX for Windows, there may also be DOS configuration files (not shown here). 


Table 1-1. The iRMX Configuration Files 


Filename 

Purpose 

Modify With 

Takes Effect 

cdf 

Client definition file 
(CDF), verifies networked 
systems 

modcdf command 

Immediately 

udf 

User definition file (UDF) 

password command 

Immediately 

user/<username> 

User attributes file 

password command 
and/or text editor 

Next logon 

terminal(s) ^ 

Terminal configuration file 

text editor 

On reboot ^ 

termcap 

Terminal definition file 

text editor 

On reboot 

r?init 2 

Hidden system 
initialization file 

text editor 

On reboot 

loadinfo ^ 

System load file 

text editor 

On reboot 

rmx.ini ^ 

Overrides iRMX for 
Windows/iRMX for PCs 
configuration defaults 

text editor 

On reboot 

r?init2 ® 

Hidden system 
initialization file 

text editor 

On reboot 


^ On the iRMX file system, this file is named terminals, on the DOS file system it is restricted to 8 
characters. At the IRMX for Windows prompt refer to the file with either name. 

^ From the DOS prompt this is a hidden file with the name init. 

^ You do not need to reboot the system if you edit the files under DOS and have not yet started IRMX for 
Windows. 

^ This file is submitted by r?init at reboot. 

^ This applies only in IRMX for Windows and IRMX for PCs. 

® Present if TCP/IP is installed. 

Backup copies of these files are installed in the :config:default directory. Save the 
backup copies to preserve the original syntax. In iRMX for Windows and iRMX 
for PCs, you cannot copy original files from the installation diskettes because they 
are in compressed format. Only the iRMX installation utility can retrieve these 
files. 
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HI Initialization and Logon 

Configuration files run automatically on system bootup, and during logon and 

logoff. Understanding the Human Interface (HI) initialization helps you decide 

which configuration changes to make and how those changes affect the system. 

The HI uses several configuration files while performing these steps: 

1. Creates the Super and World users (performs all subsequent steps as Super). 

2. Sets the system date and time to values read from the global battery-backed 
clock. 

3. Reads the :config: terminals file in preparation for terminal initialization later. 

4. Executes command lines in :config:r?init. The execution occurs in the context 
of the first terminal defined in the :config:terminals file. You can add 
commands to the r?init file directly. The default command line is: 

submit : conf ig : loadinf o over : conf ig : loadinf o . log 

This executes command lines in :config: loadinf o (and sends output to 
:config:loadinfo.log). The default loadinfo file contains a series of sysload 
commands that load jobs and file and device drivers. Comment characters 
(semicolons) in the file determine which commands execute. Adding sysload 
commands enables you to load your application, or any other commands you 
want to run at this point. 

5. Brings up terminals designated in :config: terminals. This file defines each 
terminal as either static or dynamic. A static terminal has a unique user name 
and ID associated with it, regardless of how many different people use it. 

There is no logon or logoff; rather, the HI starts the user job and displays the 
command interface prompt. At dynamic terminals, the HI prompts for a logon 
before doing the same. 

6. Concurrently with Step 5, executes any commands in :config:r?init2, if it 
exists. 


iS> Note 

You can change the system configuration file (SCF) from the 
default of :config:r?init to any other file in the tconfig: directory 
using one of these methods: 

• SCF parameter on the HI screen of the ICU 

• SCF parameter in the rmx.ini file (see Chapter 5) 

• rq_hscf BPS parameter (see MSA for the iRMX Operating 
System) 
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If you change the SCF, the HI does not execute commands from 
:config:r?init2 in Step 6. Instead it attempts to execute from a 
file with the same name as the new SCF, but with the number 2 
appended to the filename. 

The HI runs the SCF (and any files submitted by it, such as 
loadinfo) as the Super user, so they affect all users in the system. 

The submit command that runs at this time is an internal HI 
version of the command, not the CLI version. So there is no CLI 
support, including support for command aliases. 

See also: submit, CLI, Command Reference 

What Happens During Logon 

When a user logs on, the HI scans the :config:udf file, verifies the password, gets 
the user ID, and: 

1. Checks the appropriate user attributes file {:config:user/<username> where 
<username> is the logon name). This file tells the HI which initial program to 
load (iRMX CLI or a custom command interface you have written), and other 
information related to this user. 

2. Invokes the initial program. The default CLI displays a sign-on message, runs 
the logon command file :prog:r?logon that submits the user-modifiable 
:config:alias.csd and :prog:alias.csd files, and then issues a command line 
prompt. 

End a session at a dynamic terminal with the logoff command. The CLI submits 
the :prog:r?logojf file. As with the logon file, users can modify their own 
individual logoff file. 

Logon Error Messages 

The HI allocates a memory pool for each static user and for each dynamic user who 
logs on. If the HI cannot allocate the amount of memory requested, but has enough 
memory to activate the CLI, the HI allocates all the free memory available and 
displays this warning on the user's screen: 

*** WARNING: The system cannot provide the minimum memory 
*** you requested. You will come up with all the memory 
*** that is currently available in the system. If 
*** this is a problem, contact the system administrator. 
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If there is not enough memory to create the user's job, this message appears: 

*** HI LOGON ERROR: Insufficient user memory available at 
*** this time. Try to logon again later. 

The Resident/Recovery User 

You can use the ICU to specify a resident/recovery user, with Super user access 
rights. The resident/recovery user supplies access to the system if the HI fails to 
initialize. There is no logon for this user. If the HI detects a problem while 
initializing terminals, the resident/recovery user is enabled on the first terminal 
defined in the :config: terminals file, and the HI displays this error message : 

*** Recovery User created 

Logging On and Remote File Access 

If your system is configured to include the iRMX-NET client job, any user on the 
system who gains access to the HI by logging on, automatically becomes a verified 
user. In an OpenNET network system, a verified user can access files on remote 
systems through iRMX-NET. User IDs for static terminals are not verified users. 

Configuring System Jobs and Device Drivers 

In any of the OSs, you can configure system jobs and file and device drivers by 
adding loadable jobs and drivers. You can also configure most system jobs and 
device drivers in the ICU. Most ICU-configurable jobs and drivers are also 
provided in their loadable form. 

Use the provided loadable jobs and drivers as starting points in the development of 
your own application system. Use the sysload command to load these drivers to 
allow testing and debug during run time. After development, use the ICU to 
configure jobs and devices into the OS. 

See also: sysload command. Chapter 3, 

Loadable Jobs and Drivers, Chapter 4, 

ICU-configurable jobs. Chapter 6, 

IDEVS screen for drivers, ICU User's Guide and Quick Reference 
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Load-time Configuration 

In iRMX for Windows and iRMX for PCs, OS layers, drivers, and jobs are 
preconfigured with default values during installation. You can override some of 
these values with entries in the rmx.ini file. Changing values in the rmx.ini file 
changes the configuration. The default rmx.ini file contains strings for values that 
are the same as those preconfigured into the OS. If you change any values, the 
next time you boot the OS, those values are set as each layer loads. 

See also: Default configuration. Programming Concepts for DOS and Windows 


iS> Note 

The iRMX III OS does not include the rmx.ini file, and loadable 
jobs in these systems cannot take advantage of such a file. 
However, in a Multibus II system you can do some load time 
configuration of an iRMX III system by making changes in the 
BPS file. 

See also: BPS parameters, MSA for the iRMX Operating 

System 


□ □ □ 
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Configuring Users and Terminais 


Adding Users to the System 

Use the password command to modify entries in the User Definition File (UDF) 
and create a user home directory and a user attributes file. If you delete a user with 
the password command, only the UDF entry for that user is deleted; all other user 
files remain intact. 

See also: password, Command Reference, for creating and deleting users 

User Definition File 

The UDF {:config:udf f\\e) contains the logon name, user ID, and encrypted 
password (dynamic terminals only) for all users. iRMX-NET uses this file to 
validate user access to the network. 

Passwords in :config:udf ars encrypted to prevent unauthorized access. The 
password command maintains the format of the file and automatically encrypts the 
passwords. Do not edit the :config:udf file directly. 

User Home Directory 

When you add a user to the system, the password command creates a user home 
directory unless you tell it not to. The home directory is the user's working 
directory immediately after logon. The default directory created by password is 
:sd:user/<username>, where <username> is the logon name of the new user. In 
this directory, password creates a prog subdirectory containing three files: 
alias. csd, r?logon and r?logoJf. These files determine actions that happen 
automatically when that user logs on and off the system. 

See also: What happens during logon. Chapter 1 

The password command installs alias. csd, r?logon and r? logoff files from copies 
in the :config:default directory. To change the default logon and logoff actions for 
all users, modify these files before creating users. If you want the same changes to 
apply to the World and Super users, edit the same files in the :sd:user/super/prog 
and :sd:user/world/prog directories. 
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User Attributes File 

For each user on the system, the password command creates a user attributes file in 
the :config:user directory. The filename is :config:user/<username>. You can 
modify the file with a text editor to change the attributes. This file has 
these entries: 

mi n i mum_p o o l_s i z e 

Specifies the minimum size, in Kbytes, of the memory pool that the 
HI assigns to the interactive job for this user. 

maximum_pool_size 

Specifies the maximum size, in Kbytes, in the user job's memory pool. 
The difference between the maximum and minimum values is 
borrowed from the parent job, if necessary. 

max_t a s k_p r i o r i t y 

Specifies the maximum priority (numerically lowest) that any task 
associated with this user can have (from 0 to 255). This value 
determines the priority of the initial task (CLI or a custom interface). 
Recommended values are a user priority lower (numerically higher) 
than 141, and a Super user priority of 141. The World user's default 
priority, and the priority of any user created with the password 
command, is 142. 

def ault_pref ix_pathname 

This user's default home directory, establishing the :home: and initial 
:$: directory. This is normally the :sd:user/<username> directory. 
The directory specified in this field must exist or the user will be 
unable to access the HI. 

init ial_program 

Pathname of the file containing the user's initial program. If there is 
no entry here, the iRMX CLI is used as the default. 

You can specify your application program as the initial program for a 
particular user. Depending on the purpose of the application, it may 
not need a CLI. 

See also: Chapter 7 

For example, here is a user attributes file with the pathname :config:user/steve: 

1024,2048,150, : sd : user /steve 

The attributes are separated by commas and no spaces. Since a command interface 
is not specified (there is no final field), Steve's command interface is the iRMX 
CLI. 
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User Job Priority and DOS Priority in iRMX for Windows 

In iRMX for Windows, DOS and Windows operations are fixed at priority 254. 

The default user max_task_priority is 142. With these priorities, activity at 
the iRMX prompt preempts the DOS command interface. The DOS command 
interface polls the processor, rather than being interrupt-driven, so DOS uses 
processor time even when idle. 

If you set the user max_task_priority to 253, DOS and iRMX commands have 
equal priority, sharing the processor in equal time slices. Although DOS priority is 
254, 253 is correct for users because the CLI lowers the maximum priority by one 
for child jobs and their initial tasks. In other words, commands entered at the CLI 
prompt operate at a priority of one lower (numerically higher) than 
max_task_priority. 

See also: Child jobs. System Concepts 

The exceptions to this rule are the submit and background commands. The 
submit command lowers the priority one unit below that set by the CLI, for each 
invocation (nested submit commands each lower the priority by one). The 
background command lowers the priority by three units below that set by the CLI. 

If you were to set the user max_task_priority numerically greater than 253, the 
DOS task would preempt all iRMX user commands. For the submit and 
background commands, this would occur even for higher user priorities, 
depending on the nesting level of these commands. 

To avoid this situation, the OS prevents any iRMX tasks from using priority 255, 
forcing them to priority 254. This means: 

• iRMX tasks created at priority 254 or 255 can share processor time with DOS 

• Commands invoked from the HI at priority 253 or 254 can share processor 
time with DOS 

• The background command fails with an E_PARAM exception if invoked by 
an HI user at a priority lower (numerically higher) than 25 1 

• Background programs cannot share processor time with DOS 

• Any iRMX tasks that share the processor with DOS (and thus Windows) will 
take longer to execute than if they operated at a higher priority. This is 
because they operate in round-robin fashion with the DOS task, which is 
always in the ready state. 
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Configuring Terminais 

Adding or changing information in the following files defines new terminal types 
or defines how terminals operate: 

• Terminal configuration file, :config: terminals 

• Terminal definition file, :config:termcap 

Terminal Configuration File 

The terminal configuration file, :config: terminals, specifies which terminals the HI 
attaches to the system. This file contains the terminal device names, the terminal 
type, and the names of users associated with static terminals. You can edit this file 
directly to add or delete terminals from the system. There is only one terminal 
configuration file per application system, and its name is fixed. 

The terminal configuration file on the system device {:sd:) contains information 
about local terminals and, if it is an iRMX-NET server, can also contain 
information about terminals for remote diskless systems. During initialization, the 
HI determines whether the system device is local or remote. If it is local, the HI 
initializes local terminals defined in the first part of the tconfig: terminals file. If 
the system device is remote, the HI initializes terminals defined in a subsequent 
section of the file. 


iS> Note 

You can force the HI to use a different file than terminals for 
terminal initialization. Specify the terminal configuration file in 
the TCP parameter of the rmx.ini file or in the rq_hterm 
parameter of a BPS file on a Multibus II system. 

See also: Chapter 5 for rmx.ini parameters 

BPS, MSA for the iRMX Operating System 

When Changes to the Terminal Configuration File Take Effect 

Each static terminal is configured for a specific user. When the HI starts running, 
it stores the information about the terminal in memory. If you change information 
about a static terminal's user or attributes for the user, the change does not take 
effect until you reboot the system. 

If you change the terminal type of a dynamic terminal in the terminal configuration 
file, the change takes effect the next time a user logs on to the terminal. However, 
changes made to the number of terminals or to the device names do not take effect 
until you reboot the system. 
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Configuration of Locai Terminais 

The first line in the :config:terminals file is an integer specifying the number of 
local terminals the HI initializes. Each succeeding line specifies attributes of a 
single terminal device as follows: 

device_name, [user_name] , reserved, [terminal_type ] 

Where: 

device_name 

The physical device name (DUIB name) of the terminal as specified 
in the ICU or in a loadable terminal device driver. 

See also: DUIB names for terminal devices. Chapter 4 

user_name If there is only a comma here (as a placeholder), this is a dynamic 
terminal. Any user verified in the UDF can log on. Placing a user 
logon name here, three to eight characters long, specifies a static 
terminal. On initialization, the HI automatically logs this user on to 
this terminal. The static user must have an entry in the UDF and have 
a user attributes file. 

reserved Reserved; use a comma as a placeholder. 
terminal_type 

Specifies a terminal name from the terminal definition file. The 
default value is ANY, which applies to all terminal types. Entering a 
name for a specific terminal type enables the full screen-editing 
features of the CFI. 

During HI initialization, memory for all static terminals is allocated in the order 
they appear in the :config: terminals file. To ensure that high-priority terminals 
have access to the system, list static terminals in order of their importance. 

In iRMX for Windows, DOS applications can access any serial device not attached 
by the iRMX OS. When the iRMX OS attaches a serial device, it traps the device's 
interrupt; DOS applications cannot use that interrupt or the associated I/O port(s). 

If you intend to use a serial device from DOS, do not enter the device name in the 
:config: terminals file or attach it with the attachdevice command. 


A CAUTION 

The tconfig: terminals file is only for initializing user logon 
devices. If a mouse is attached to a terminal that is specified in 
the tconfig: terminals file (such as COMl or COM2), the system 
will hang. This occurs either during HI initialization or when the 
mouse is accessed from DOS or Windows. 
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Configuration of Remote Terminais 

Use the :config: terminals file to initialize terminals on remote diskless systems that 
use the file server as their system device. In this case, the file contains several 
additional lines: 

numb e r_o f _t e rmi n a 1 s_f o r_l oca l_h o s t 
local_terminals 
// 

number_of_terminals_remote_host #1 , remote_host#l_name 
remote_host_terminals 
// 

number_of_terminals_remote_host #2 , remote_host#2_name 
remote_host_terminals 
// 


// 

Where: 

numb e r_o f _t e rmi n a 1 s_f o r_l oca l_h o s t 
local_terminals 

The number of terminals and associated terminal configuration entries 
for the file server. Local_terminals lines are the same as 
described previously. 

/ / A delimiter between groups of terminal configurations. 

numbe r_o f _t e rmi nals_remot e_h o s t # x 

The number of terminals to attach for a remote host. 

remote_host #x_name 

The network node name of the remote host that gets system device 
services from this system. This is the name cataloged with the 
iRMX-NET Name Server. 

See also: Name server. Network User's Guide and Reference 

remote_host_terminals 

The terminal configuration lines for the remote system. 
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Terminal Configuration File Examples 

This example :config:terminals is for an iRMX for Windows system with three 
terminals: two are dynamic and one is static. 

3 

d_cons , , , PC 
coml , , , any 
com2, ted, , VTIOO 
t550_0 , , , any 

The d_ _cons device is the DOS console device provided by the loadable keybd.job. 
The second and third devices are the COMl and COM2 serial ports on a PC, 
resident in the OS. COM2 is set up as a static terminal for user ted. There is a 
fourth device: the hSSOdrv loadable device driver; if you change the first line of 
this :config: terminals file to 4 instead of 3, this device would be initialized on 
reboot. 

System console output during initialization is always sent to the first terminal in 
:config: terminals. In this example, the output from :config:r?init (and 
:config:loadinfo) does not appear because d_cons is loadable and not yet 
available. 

See also: HI Initialization and logon. Chapter 1, 

Loading and unlocking terminal devices. Chapter 3, 
keybd.job. Chapter 4 

The next example is for a Multibus II system running the iRMX III OS. The board 
that attaches the hard disk is the local host. The remote hosts are other boards in 
the system (named slot 3, slot 4, slots, and slot 6) that use terminals 
associated with their names: 

1 

to, , , wysSO 
// 

1, slot3 
t279_l , , , rgi 
// 

1, slot4 
t279_2 , , , rgi 
// 

1, slots 
t279_3 , , , rgi 
// 

1 , slots 

t279_4 , , , rgi 
// 
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Terminal Definition File 


The terminal definition file, :config:termcap, defines the terminal types and their 
characteristics. There is only one terminal definition file in the system. Terminal 
types used in :config: terminals must be defined in the :config:termcap. You can 
edit this file directly to add or delete terminal types from the system. The 
configuration commands in the :config:termcap are used by the CLI and the 
AEDIT editor, and include parameters and control sequences specifying how the 
CLI function keys operate. Following are some common terminal types; refer to 
the :config:termcap file on your system for other terminal types that may also be 
defined. 


Terminal Type 

ANY 

1510E 

1510T 

ADM3A 

AT386 

RMXPC or PC 

QVT102 

RGI 

S120 

TV910P 

TV950 

VT100 

VT102 

VT52 

WYSE50 or WY50 

XTERM 

ZENTEC 


Description 

Default ANSI terminal for terminals not listed 

Hazeltine 1510 with escape lead-in 

Hazeltine 1510 with tilde lead-in 

Lear Seigler ADM-3A 

PC system console 

PC system console 

Qume QVT 1 02, in QVT 1 02 mode 

SBX 279 Graphic Subsystem 

PC system console 

Televideo 910 Plus 

Televideo 950 

DEC VT100, VT101 (also for Wyse 75 and Wyse 85) 

DEC VT102 

DEC VT52 

Wyse 30, Wyse 50 

X-Windows terminal 

Zentec Zephyr and Cobra 


The format of a terminal definition in :config:termcap is shown below. Use either 
a semicolon (;) or a space as a separator. 


name = terminal_name; 

code = value; code = value; [...] 

// 

Where; 

name = terminal_name 

Up to seven characters specifying a name for this terminal type. 

code An input or output code, as shown in Table 2-1. 

value A hexadecimal value for the ASCII character(s) that correspond to 
this code. Do not follow the value with an H. 

/ / A delimiter for each terminal definition in the file. 
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Terminal Control Codes 

Table 2-1 lists the control codes used in :config:termcap. Some are used to define 
CLI function keys, others are used by the AEDIT editor. 

See also; CLI function keys, Command Reference', 

Function keys, AEDIT User’s Guide 


Table 2-1. Terminal Control Codes for CLI Function Keys 


INPUT CODES 


Codes 

Meaning 

AB= hhhh 

Sets <Esc> 

AFCL= hhhh 

Sets <Left-Arrow> 

AFCR= hhhh 

Sets <Right-Arrow> 

AFCU= hhhh 

Sets <Up-Arrow> 

AFCD= hhhh 

Sets <Down-Arrow> 

AFCH= hhhh 

Sets <Flome> 

AR= hhhh 

Sets <Rubout> (<Backspace> or <Del>) 

AFXF= hhhh 

Sets delete character <DelCh> 

AFXA= hhhh 

Sets delete right <DelR> 

AFXX= hhhh 

Sets delete left <DelL> 

OUTPUT CODES 


Codes 

Meaning 

AFMB= hhhh 

Moves cursor to start of line 

AFML= hhhh 

Moves oursor left 

AFMR= hhhh 

Moves oursor right 

AFEK= hhhh 

Erases entire line 

AFEL= hhhh 

Erases to the end of the line 

BELL= hhhh 

Beeps the terminal bell 


hhhh represents a 1 to 4-byte hexadecimal number (2 to 8 characters) 

You can also specify a null value for a control code. Then, the CLI tries to bypass 
the missing output character by simulating its function. For example, if a terminal 
has no rubout character, specify AR= ; . 

If a function is not available on a terminal, set the corresponding code to FF. 

If you are not sure which terminals the system includes, or for compatibility with 
previous iRMX releases, use the ANY terminal type defined in the termcap file. 
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Terminal Definition Example 

This is an example terminal definition used to access the iRMX OS from a UNIX 
X-Window with remote (virtual terminal) software. The first half of the definition 
is used by the CLI and the second half is used by the AEDIT editor. 


NAME 

= XTERM; 



AFCL 

= 1B5B44; AFCR = 

1B5B43; AFCU = 

1B5B41; AFCD 

AFML 

= 1B5B44; AFMR = 

1B5B43; AFMB = 

OD; 

AFXA 

= 01; AFXF = 06; 

AFXX = 18; 


AFEK 

= 1B5B324B; AFEL 

= 1B5B4B; 


BELL 

= 07; 



AFMU 

= 1B5B41; AFMD = 

1B5B42; AFMH = 

1B5B48; 

AFES 

= 1B5B324A; AFER 

= 1B5B4A; 


AFDL 

= ; AFIL = ; 



AFRV 

= 1B5B376D; AFNV 

= 1B5B306D; 


AI = 

H 

> 

O 

II 

H 



AH = 

VTIOO; 



AB = 

IB; AR = 08; AFCH = 1B5B48; 


AV = 

24; 



// 





1B5B42; 


How the CLI Uses Terminal Support Code 

The Terminal Support Code (TSC) is a support library for terminal device drivers 
that use the iRMX BIOS. The CLI uses some TSC features and you can use the 
TSC in the design of your own command interface. This section describes TSC 
features used by the CLI: type-ahead buffers, default control characters, and 
escape sequences. 

See also: Terminal support code. Driver Programming Concepts for a complete 

specification of TSC features 

When you enter characters at a terminal, the TSC sends the first line to the OS for 
processing and stores additional lines in a type-ahead buffer. It sends the next line 
in the buffer to the OS after the OS finishes with the first line. If the type-ahead 
buffer becomes full, the TSC sounds the terminal bell and refuses to accept input. 

The TSC also provides control character support that the CLI uses by default. 

Table 2-2 summarizes these characters. 
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Table 2-2. Default TSC Control Characters 


DEFAULT INPUT CONTROL CHARACTERS 

Character 

Results 

<carriage return> 
or <line feed> 

Terminates current line with a <CR>-<LF> combination and puts 
cursor at start of next line 

<Rubout> 

Deletes a single character; depending on TSC configuration, it 
removes the character or echoes it to the display surrounded by # 
characters 

<Ctrl-P> 

Removes any special meaning from immediately following input 
control characters; has no effect on output control characters such 
as <Ctrl-C> 

<Ctrl-R> 

Reprints a line with editing performed (not used by CLI, except with 
terminal type “ANY”) 

<Ctrl-U> 

Discards contents of the type-ahead buffer 

<Ctrl-X> 

Discards the current input line 

<Ctrl-Z> 

Specifies an end-of-file 

DEFAULT OUTPUT CONTROL CHARACTERS 

Character 

Results 

<Ctrl-0> 

Toggles the terminal in and out of discarding mode 

<Ctrl-Q> 

Resumes previous output mode, reversing the effects of a <Ctrl-S>, 
<Ctrl-W>, <Ctrl-T>, or <Ctrl-0> 

<Ctrl-S> 

Stops output display; has no effect after a <Ctrl-0> 

<Ctrl-T> 

Scrolls output one line at a time 

<Ctrl-W> 

Scrolls output one screen at a time 

<Ctrl-C> 

Aborts currently executing program (but not background jobs) 


The TSC also accepts escape characters that enable you to further define a 
terminal. For example, you could set the scroll count or switch your terminal into 
transparent mode so that control characters have no effect. You can enter these 
escape characters from the terminal, or you can write them to the terminal from a 
program. The CLI does not use TSC escape sequences other than those for codes 
defined in Table 2-1. 
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Configuring Terminais for a Modem 

This section explains how to set up a modem for use on the iRMX end of a modem 

link. 

See also: Documentation for your modem or terminal for how to connect or use 

a modem on the terminal end 

Before attempting to use a modem with an iRMX system, ensure that the port to 

which you connect the modem is configured as a modem link: 

• In ICU-configurable systems, use the ICU to set the Modem Control (MC) 
parameter of the terminal driver to yes. 

• In iRMX for Windows and iRMX for PCs systems, you must change the 
loadable terminal driver so that the Unit Information (UINFO) table is set for 
modem control; set bit 3 of terminal_f lags to 1 . There are two ways to do 
this: 


_ Use the BIOS a_special system call to set the terminal attributes (Function 
5). Set bit 3 of the terminal_f lags field to 1 (this method is not for 
dynamic terminals). 

See also: a_special. System Call Reference 

_ Change the source code for the loadable driver's configuration file and 
rebuild the driver. For example, the source code for the HOSTESS 550 
terminal driver includes a configuration file named h550cfg.a38. This file 
defines a single UINFO table named UINFO_550 that is used by all the 
DUIBs for the driver (T550_0 through T550_7). UINFO_550 sets 
term_f lags to OIOIH. Create a different UINFO table with 
term_f lags set to 0109H. Specify your new UINFO table name in the 
DUIB(s) to be used with the modem. 

You could also create new DUIB names (for example T550_0M rather 
than T550_0) that reference the new UINFO table, and specify them in the 
jconfig: terminals file and load your new version of the hSSOdrv driver. 
You could use this same method to rebuild the comdrv driver to set up 
COMl or COM2 for a modem. 

See also: Loading and unlocking terminal devices. Chapter 3, 

comdrv. Chapter 4, 

UINFO table structure for a terminal driver, making a device driver 
loadable. Driver Programming Concepts 
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Setting Up the Modem 

Set up a Hayes-compatible modem as follows: 


Switch 

Setting 

DTR (Data Terminal Ready) 

Normal 

DSR (Data Set Ready) 

Normal 

Carrier Detect 

Normal 

Auto Answer 

Enabled 

Command Response 

Suppress 

Command Mode 

Disabled 


Once these have been set, and both sides of the modem link are properly cabled, 
the modem link is ready. Use the modem on the terminal end of the link to dial up 
the iRMX system. When the modem answers, the dynamic logon procedure asserts 
the DTR signal. The word CONNECT appears on your terminal. If the serial port on 
the iRMX end of the link has an auto-band search, enter four capital us (at a rate of 
about two per second) and a <CR>. If your terminal is not configured for auto- 
band search enter <CR>. The terminal should now respond as if it were connected 
to the iRMX system by a dedicated line. The response from a modem link operates 
at the baud rate of the modem and therefore may be noticeably slower than a true 
dedicated line. 
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Configuring a Muitiuser Environment 

On a multiuser system, you may want to control access to a system's files and 
devices. This discussion only applies if you install the OS on an iRMX hard disk 
partition. In this case, the named file driver provides file access control according 
to user IDs. If you install iRMX for Windows or iRMX for PCs on a DOS file 
system, this discussion does not apply. You can protect your system in these ways: 

• Limit access to the configuration files. 

• Allow only the system administrator to detach system devices by ensuring that 
only the Super user has all access rights to the :sd: root directory. 

• Allow users to be owners of their default directories and restrict access to other 
files and directories. 

• Allow the World user read access to files and list access to directories 
containing commands and utilities, but disallow users to delete or modify files 
in those directories. 

• Allow the World user full access to the :work: directory; this is required to use 
the compilers and development tools. 

Changing Access Rights 

Use the permit command to change access rights for files and directories. This 
command adds or removes users from a file's access list and set specific access 
rights for these users. You can give only three users access rights to any file or 
directory. Display the access rights for files and directories with the dir command. 

See also: dir, permit. Command Reference 

Fiie Structure of a Muitiuser Environment 

The :sd: directory is the root directory for the system device. The Super user owns 
this directory. Other users can have list access to allow them to view the files in 
the root directory. However, they should not have change-entry or delete access to 
the root directory. Add-entry access is optional. 

Four first-level directories store commands and utilities. They are :lang:, :utils:, 
:util286:, and .-system:. The Super user owns these directories and the files they 
contain. To protect the commands and utilities from damage or deletion, other 
users should have only list access to the directories (to be able to see what is 
available) and read access to the data files (to be able to run the commands). 

□ □ □ 
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Configuring Loadable 
Jobs and Drivers 


You configure loadable jobs and drivers when they are loaded by the sysload 
command. The loaded job or driver becomes part of the OS, as a child job of the 
HI. When loaded, the job or driver becomes resident in memory. It remains part 
of the OS until it explicitly exits or until the system is rebooted. 

Run sysload from the command line or from a submit file. You can use sysload 
while testing drivers and jobs, before configuring them as part of a bootable system 
with the ICU. 

In iRMX for Windows and iRMX for PCs, you use the :config:loadinfo file, 
containing a series of sysload commands, to load drivers and jobs automatically 
during system initialization. The default loadinfo file has command lines for each 
loadable job or driver, with some commented out. 

iS> Note 

Typically the r?init file contains a line to submit the loadinfo file. 

If you need more than one loadinfo file (for example, on a system 
that supports other remotely-booted systems), you may want to 
use different versions of the r?init file to submit different versions 
of the loadinfo file. You can force the HI to use a different file 
than r?init for its initialization. Specify the initialization file in 
the SCF parameter of the rmx.ini file or in the rq_hscf 
parameter of a BPS file on a Multibus II system. 

See also: Chapter 5 for rmx.ini parameters 

BPS parameters, MSA for the iRMX Operating 
System 

Loading some jobs may also require that you change the rmx.ini load-time 
configuration file or DOS configuration files. 

See also: rmx.ini file. Chapter 5, 

ICU-configurable jobs. Chapter 6, 

Writing loadable drivers. Driver Programming Concepts 
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Using the Sysload Command 

Invoking sysload -1 lists the currently loaded jobs and drivers. When loading 
jobs and drivers, the command syntax is: 

sysload [switch] [(min, max)] pathname [driver_params ] 

Where: 

switch Optional command line switches: 

Value Meaning 

-i name Specifies a file, logical name, or logical device as the 
:ci: (standard input) for the loaded job. 

-I List the names of all jobs and drivers currently loaded 

through this facility. 

-0 name Specifies a file, logical name, or logical device as the 
:co: (standard output) for the loaded job. 

-r Load this job over an existing instance. The existing job 

is deleted only after successful loading. 

-u name Unload a job by deleting it; specify either the job name 
or token. 

Note: Not all jobs can be successfully unloaded 

-w Wait for job initialization to complete using a 

configurable timeout value. 

See also: Job synchronization timeout (JST), Chapter 5 

(min, max) Minimum and maximum sizes in Kbytes of the memory pool 

required. If not specified, default values built into the job or driver 
are used. If you specify min, you must also specify max. Enclose the 
values with parentheses and separate them with a comma. 

pathname The full pathname of the job or driver, for example, 

/rmx386/drivers/ramdrv . This pathname must begin at the root 
directory and can include logical names. 

driver_params 

Parameters specific to the job or driver being loaded (if any). The 
syntax of parameters is defined by each job and driver; sysload passes 
them directly. Some drivers provided with the OS require parameters 
to be enclosed in parentheses; parentheses are optional otherwise. 

See also: sysload. Command Reference 
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How Jobs and Drivers Handle Sysload Switches 

To handle the command-line switches -w, -u, and -r, the job or driver itself may 
need to take some action. Loadable jobs or drivers that you create should follow 
the guidelines discussed here. 

The -w (Wait) Switch 

When you specify the -w switch, the sysload command attempts to synchronize 
with the new job's initialization by blocking until the initialization is complete. 
First sysload creates the new job. Then, if the -w switch is specified, sysload looks 
up the object R?END_INIT in the new job's object directory and waits for the 
object to be cataloged. The wait period is controlled by the JST timeout parameter. 
Set JST either in the :config:rmx.ini file or on the HI screen of the ICU. The 
default wait period is 60 seconds. 

It is expected that the job will catalog an R?END_INIT object (a null token is OK) 
when its initialization is complete. If the job fails to catalog R?END_INIT, the 
lookup will timeout after the configured time or the default time. Thus, if you do 
not set JST shorter, any sysload -w invocation of a job that does not catalog an 
R?END_INIT object will always take 60 seconds before the command terminates. 

The -u (Unload) Switch 

When you specify the -u switch, the sysload command attempts to delete a loaded 
job, using one of these mechanisms: 

• Eirst sysload looks up a data mailbox object with the name R?EXIT_MBX in 
the specified job. If this object exists, the sysload command does not delete 
the job directly. Instead, sysload sends to the mailbox a 2-byte data message 
with the exception code OEEDDH, meaning E_DELETE_YOURSELE. Then 
sysload waits until the job deletes itself before returning. The job is expected 
to have a task waiting at this mailbox that will receive the message, perform 
any cleanup, and delete the job. The job must create and catalog this mailbox 
during its initialization to allow itself to control its own deletion. 

• If the R?EXIT_MBOX object does not exist, or if any error occurs during the 
lookup, sysload attempts to delete the job normally by calling rq_deletejob. 

This mechanism lets a job control its own deletion in an orderly fashion and free 
any resources under its control. 
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iS> Note 

Many of the loadable jobs and drivers provided with the OS 
cannot be successfully removed with the -u switch. See the 
descriptions in Chapter 4 for jobs that support this switch. 

The -r (Reload) Switch 

When you specify the -r switch, the sysload command first loads and starts a new 
instance of the specified job or driver, then deletes the previous instance. The 
command uses the same mechanism described for the -u switch to delete the 
previous instance of the job or driver. 

iS> Note 

Only jobs and drivers that support the -u switch can successfully 
be reloaded with the -r switch. 

Log Files 

Loadable jobs and drivers create a log file in the directory for that job or driver. 
The log file has the name of the job or driver with a . log extension. The sign-on 
message from the loaded driver indicates that the operation is successful. 
Otherwise, an appropriate error message appears in the log file. 

Using a Loaded Device Driver 

After loading a device driver, invoke the attachdevice command using one of the 
DUIB names installed by the driver. Device drivers take effect immediately after 
loading. If you re-load the driver (with the -r switch) the new DUIB is used the 
next time you invoke attachdevice. 

See also: attachdevice. Command Reference 

Testing the Configuration 

Test or debug your system by adding loadable drivers and jobs while the system is 
running. This lets you experiment with the configuration while observing system 
performance. To do this, invoke sysload from the command line, rather than from 
the loadinfo file. The changes disappear when you reset or reboot the system. 

For example, to load the ram disk driver with a 1024 Kbyte disk, enter this at the 
iRMX prompt: 

sysload /rmx38 6/dr iver s/ramdrv (1024) 
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A log file named ramdrv.log is created. Access the ram disk like any other device. 
See also: ramdrv, Chapter 4 


Example Loadinfo File 

Figure 3-1 is an example :config: loadinfo file. It contains sysload commands for 
each loadable job and device driver available to the system. Not all of these are 
loaded by default. Some of the lines are commented out (disabled) by a preceding 
semicolon (;). Some of the jobs are mutually exclusive, others are not selected 
during installation. You may also add your own sysload commands for terminals, 
application jobs, or custom drivers. Changes made to the :config: loadinfo file take 
effect on reboot. 

See also: Your :config: loadinfo file. 

Descriptions of loadable jobs and drivers. Chapter 4 


; iRMX System Jobs 

; Shared C Library Job 
sysload /rmx38 6/ jobs/clib . job 
; System Debugger (SDB) Job 
sysload /rmx38 6/ jobs/sdb . job 
; Soft-Scope III Kernel Job 
; sysload /util38 6/sskernel 
; Keyboard/Console Job 

sysload -w /rmx38 6/ jobs/keybd . job (f,l,ffff) 

; HMA/XMS Services Job 

sysload (1096,1096) /rmx38 6/ jobs/himem . job 32 
; Standard Mode Windows Job 
sysload /rmx38 6/ jobs/smw . job 


Figure 3-1. Loadinfo File Example 
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iNA 960 Network Jobs for PC Systems 


; COMMputer Job (EtherExpress™ 16) ES-IS Network Layer 
;sysload -w /rmx38 6/ jobs/iethxpe . job 

; COMMputer Job (EtherExpress 16) Null2 Network Layer 
;sysload -w /rmx38 6/ jobs/iethxpn . job 

; COMMputer Job (EtherExpress PRO/10) ES-IS Network Layer 
;sysload -w /rmx38 6/ jobs/iethproe . job 

; COMMputer Job (EtherExpress PRO/10) Null2 Network Layer 
;sysload -w /rmx38 6/ jobs/iethpron . job 

; Professional Workstation (LP486) COMMputer Job ES-IS Network Layer 
;sysload -w /rmx38 6/ jobs/i4 8 6hide . job 

; Professional Workstation (LP486) COMMputer Job Null2 Network Layer 
;sysload -w /rmx38 6/ jobs/i4 8 6hidn . job 
; COMMengine MIP Job (PCLINK2 , PCLINK2A) 

;sysload -w /rmx38 6/ jobs/ipcl2 . job ( 3 60 , 2 1 , CCOOO ) 

; COMMputer Job (Null Subnet) - Null2 Network Layer 
;sysload -w /rmx38 6/ jobs/inlatn . job 

; iNA 960 Network Jobs for Multibus I Systems 

; SBC 386SX COMMputer Job (with SBX586) ES-IS Network Layer 
;sysload -w /rmx38 6/ jobs/i38 6sxe . job 

; SBC 386SX COMMputer Job (with SBX586) Null2 Network Layer 
;sysload -w /rmx38 6/ jobs/i38 6sxn . job 

; SBC x86/12(S), SBC 386/2x, SBC 386/3x COMMputer (SBX586) iNA 960 Job - ES-IS 
;sysload -w /rmx38 6/ jobs/isbx58 6e . job 

; SBC x86/12(S), SBC 386/2x, 386/3x COMMputer (SBX586) iNA 960 Job - Null2 
;sysload -w /rmx38 6/ jobs/isbx58 6n . job 

; SBX 586 COMMputer Job (other CPU boards) ES-IS Network Layer 
;sysload -w /rmx38 6/ jobs/isbx58 6e . job 

; SBX 586 COMMputer Job (other CPU boards) Null2 Network Layer 
;sysload -w /rmx38 6/ jobs/isbx58 6n . job 
; COMMengine MIP Job (552A) iNA 960 Job 
;sysload -w /rmx38 6/ jobs/i552a . job 

; COMMputer Job (Null Subnet) - Null2 Network Layer 
; sysload -w / rmx38 6/ jobs/ i nimbi . job 

Figure 3-1. Loadinfo File Example (continued) 
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iNA 960 Network Jobs for Multibus II Systems 


; SBC 486SX25, SBC 486DX33, SBC 486DX66 COMMputer Job (with EWENET) ES-IS 
;sysload -w /rmx38 6/ jobs/iewexpe . job 

; SBC 486SX25, SBC 486DX33, SBC 486DX66 COMMputer Job (with EWENET) Null2 
;sysload -w /rmx38 6/ jobs/iewexpn . job 

; SBC P5090 COMMputer Job (EWSII) ES-IS Network Layer 
;sysload -w /rmx38 6/ jobs/ieproe2e . job 

; SBC P5090 COMMputer Job (EWSII) Null2 Network Layer 
;sysload -w /rmx38 6/ jobs/ieproe2n . job 

; SBC 486/133SE, SBC 486/166SE COMMputer Job - ES-IS Network Layer 
;sysload -w /rmx38 6/ jobs/i4 8 6133e . job 

; SBC 486/133SE, SBC 486/166SE COMMputer Job - Null2 Network Layer 

;sysload -w /rmx38 6/ jobs/i4 8 6133n . job 

; MIX560 COMMputer Job - ES-IS Network Layer 

;sysload -w /rmx38 6/ jobs/imix5 60e . job 

; MIX560 COMMputer iNA 960 Job - Null2 Network Layer 

;sysload -w /rmx38 6/ jobs/imix5 60n . job 

; COMMengine MIP Job (186/530 default) 

;sysload -w /rmx38 6/ jobs/icemb2 . job 

; COMMputer Job (Null Subnet) - Null2 Network Layer 
; sysload -w / rmx38 6/ jobs/ inlmb2n . job 

; For All Systems 

; iRMX-Net Remote File Driver Consumer Job 

sysload /rmx38 6/ jobs/remotefd . job 

; iRMX-Net Server Job 

sysload /rmx38 6/ jobs/rnetserv . job 

; MS-DOS Network Redirector Job 

sysload /rmx38 6/ jobs/netrdr . job 

; iRMX Remote Load Server Job 

;sysload /rmx38 6/ jobs/rls . job 

; iRMX MSA Boot Server Job 

; sysload /rmx38 6/ jobs/bootserv . job 

Figure 3-1. Loadinfo File Example (continued) 
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iRMX Device Drivers 


; PC Bus COMn : Driver 

; sysload / rmx38 6/ drivers/ comdrv ( 1 , 3f 8 , 48) 

; sysload / rmx38 6/ drivers/ comdrv {2 , 2 f 8 , 38 ) 

; PC Bus Line Printer Driver 
; sysload / rmx38 6/ drivers/ Ipdrv 
; Hostess 550 Serial Board Driver 
; sysload / rmx38 6/drivers/h550drv ( 8 , 2 80, 58 ) 

; sysload / rmx38 6/drivers/h550drv ( 4 , 2 80, 58 ) 

; sysload / rmx38 6/drivers/h550drv (10, 280, 58 ) 

; DigiBoard DigiCHANNEL PC/X Serial Board Driver 
; sysload / rmx38 6/ drivers /pcxdrv (0,10,0,58) 

; sysload / rmx38 6/ drivers /pcxdrv (0,8,0,58) 

; sysload / rmx38 6/ drivers /pcxdrv (0,4,0,58) 

; Multibus I TCC driver 

; sysload / rmx38 6/drivers/tccdrv (da0000, 88a7,27,f) 

; Adaptec 1542/1742 PCI SCSI Server 
; sysload /rmx38 6/ jobs/pcisrv . job PCIADl 
; Adaptec 1542 PCI SCSI Driver 
; sysload / rmx38 6/ drivers /pcidrv ( ' AT ’ , 1 , 0 , a) 

; Multibus II PCI Driver 

; sysload /rmx3 8 6 /drivers /pcidrv ('386/258', 1,0, a) 

; sysload / rmx38 6/ drivers /pcidrv ( ' 386/258D' , 1, 0, a) 

; sysload / rmx3 8 6 /drivers /pcidrv ( ' 486/133SE' , 1, 0,a) 

; sysload / rmx38 6/ drivers /pcidrv ( ' 486/166SE' , 1, 0, a) 

; RAM Disk Driver 

; sysload / rmx38 6/ drivers/ ramdrv (1024) 

; Pseudo tty Driver - required for telnet server 
; sysload -w / rmx38 6/ drivers /pttydrv ( 8 ) 

; POSIX Layer Job 

sysload -w /rmx38 6/ jobs/posix . job 
; X.25 Client 

; sysload -w /rmx38 6/ jobs/x25cli . job 

Figure 3-1. Loadinfo File Example (continued) 
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; Multibus II ATCS Driver 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
; sysload / rmx38 6/ drivers/ atcsdrv ( 
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Figure 3-1. Loadinfo File Example (continued) 
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Loading and Unlocking Terminal Devices 

The HI attempts to initialize all terminals designated by the :config: terminals file 
after completing the execution of all commands present in the :config:r?init file. If 
any of these terminals are supported by device drivers that are not configured into 
the iRMX boot image or are not sysloaded by commands in the :config:loadinfo 
file, the HI aborts their initialization and marks them as locked. 

If you attempt to sysload from the command line a terminal driver that supports 
terminals listed in the tconfig: terminals file, these terminals are not automatically 
initialized by the HI. You must also enter an unlock command before initialization 
will take place. 

Choosing a Network Job 

The native iRMX networking jobs include iNA 960 network jobs with a 
programmatic interface only, i*.job. Each job matches a specific computer's 
hardware and software configuration. On top of an iNA 960 job you can run 
iRMX-NET client and/or server jobs to provide transparent file access and support 
iRMX-NET command-line utilities. 

Only one of the iNA 960 jobs can run at a time. Any attempt to load a second job 
will fail, and may disrupt the operation of the first job. 

See also: Network User's Guide and Reference for information about the 

features of iRMX-NET and the programmatic network interface 


iNA 960 Jobs 

The iNA 960 jobs provide programmatic access to transport services from your 
application, without transparent file access. These are called collectively i*.job. 
The selection includes: 

• COMMpu ter jobs, which use LAN hardware integrated into the host CPU 

• COMMengine jobs, which use a NIC separate from the host CPU (also called 
MIP jobs) 

• Jobs that run without network hardware, to support local ISO transport 
applications 

See also: i*.job. Chapter 4 
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iRMX-NET Jobs 


iRMX-NET provides a complete network package, including a command-line 
interface and transparent file access to remote iRMX-NET systems. Load the 
iRMX-NET job(s) after loading the underlying i*.job that is appropriate for your 
system. The jobs include: 

• iRMX-NET client, which includes the file consumer and remote file driver in a 
single job, remotefd.job 

• iRMX-NET server, rnetserv.job 

You can run one or both of these jobs depending on whether you want the system 
to be only a client, only a server, or both. 

New vs. Old Network Job Names 

A wider selection of network jobs has been provided in this release, and the 
existing file names have changed. If you are familiar with the old job names. 

Table 3-1 shows the equivalent new names to substitute. The former names 
include iRMX-NET and iNA 960 in the same job. In the list of current names, if 
you want iRMX-NET you must add the iRMX-NET client and/or server separately 


from the 

i*.job names. 



Table 3-1. 

New Network Job Names 

Old Name 

Release 2.1 Name Current Name 

mipat.job 

mipmb2.job 

ipcl2.job 

ioemb2.job 

ipcl2.job 

icemb2.job 

netat.job 
netlp486.job 
netmbi .job 
netmb2.job 

rpcl2n.job 

r486hidn.job 

r386sxn.job 

rcemb2n.job 

ipol2.job plus rnetserv.job/remotefd.job 
i486hidn.job plus rnetserv.job/remotefd.job 
i386sxn.job plus rnetserv.job/remotefd.job 
icemb2n.job plus rnetserv.job/remotefd.job 

netatn.job 
netmbi n.job 
netmb2n.job 

rnlatn.job 
rnimbi n.job 
rnlmb2n.job 

inlatn.job plus rnetserv.job/remotefd.job 
inimbi. job plus rnetserv.job/remotefd.job 
inlmb2.job plus rnetserv.job/remotefd.job 

ntp4at.job 
ntp4mb1 .job 
ntp4mb2.job 

inlatn.job 
inimbi n.job 
inlmb2n.job 

inlatn.job 
inimbi .job 
inlmb2.job 
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The ISO Transport Software 

With any of the iNA 960 jobs, your application can make calls to the various 
networking layers. The software conforms to the International Standards 
Organization (ISO) Transport Class 4 and the Open Systems Interconnection (OSI) 
model. Regardless of the job you choose, the interface to your application is the 
same. The only exception is inl*n.job, which does not include a Data Link layer or 
Network Management Facility, because it runs without network hardware. 


Loadable or First-Level Network Jobs 

You can either sysload the loadable network jobs or use the ICU to configure them 
as first-level jobs that boot with the OS. If you need to change the configuration of 
a loadable job, you can enter configuration parameters for one of the first-level jobs 
in the ICU and then produce a loadable job from it. Enter the name of the network 
job, without the .job extension, and choose the loadable option. 

See also: Network screens, ICU User's Guide and Quick Reference 

Network Jobs in the Loadinfo File 

Once you know which network job you need, check the initial loadinfo file to see 
which job it is set up to load. The initial configuration of the file depends on your 
answers to the prompts during installation. If you specify that you use a network, 
an i*.job and iRMX-NET jobs are enabled for loading in the loadinfo file. If you 
specify that you do not use a network, inl*.job and iRMX-NET are enabled for 
loading. 

If necessary, edit the file to load a different job. Be sure to comment out the old 
jobs when you enable the new ones. 

If your computer is not connected to a network and your applications do not 
communicate by making cq_ calls to the ISO Transport Software, comment out the 
network jobs. There is significant overhead to running network software. 

Timing Sequence of Loading the Network 

When you load an i*.job or iRMX-NET jobs, always use the sysload -w command, 
which starts the job and waits until the NIC is loaded before it returns. Otherwise, 
there are timing problems, if you start the iRMX OS from the autoexec.bat file and 
load from the loadinfo file. 
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Some network jobs load software onto a NIC. This can take some time: up to 30 
seconds in a PC loading ipcll.job. The iRMX OS could be running and the 
autoexec.bat file finished executing before the NIC is initialized. Attempts to do 
any network-related operations before the NIC is initialized will fail. 

Modifying the Client Definition File (CDF) 

If you load iRMX- NET, there is one other network configuration file: the client 
definition file, or CDF. Entries in the CDF specify a client (consumer) machine 
name and password. Under iRMX-NET, if a user attaches to a remote node whose 
CDF contains the name and password of the user’s local node, the user has access 
to any public directories on the remote system. (All public directories are 
accessible if installed on the DOS file system, but are subject to iRMX file access 
permissions if installed on an iRMX file system.) Modify the CDF by invoking the 
modcdf command as the Super user. 

See also: Client-based and server-based protection. Network User's Guide and 

Reference 

The node name and password are configuration values and, by default, are the same 
for all current releases of the iRMX OS. This name and password are specified in 
the default CDF. If you don't change the configuration of the CDF or of a client 
node's name and password, all iRMX systems connected by a network have access 
to the other systems' files. 

In an ICU-configurable system, use the ICU to change a node's name and 
password. In iRMX for Windows and iRMX for PCs, change these values in the 
load-time configuration. 

See also: [UA] block of the rmx.ini file. Chapter 5 
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Using iRMX-NET in a DOS Environment 

There are two ways you can use DOS network software together with iRMX-NET 
software on the iRMX for Windows OS; 

• Use any NIC supported by iNA 960 to allow simultaneous DOS and iRMX 
networking on an Ethernet network. The iRMX OS manages the NIC but DOS 
and Windows can also communicate on the network. 

• Use a null network iNA 960 job to allow network software on the DOS and 
iRMX OSs to communicate with each other on the same machine. There is no 
actual network interface, but DOS and Windows have access to iRMX- 
controlled volumes as if they were on a network. 

Both methods require that you use MS-NET software. If you use the PCL2(A) 

NIC, MS-NET is included with the product. MS-NET is also shipped with the 
iRMX OS. In any case, you must replace the standard MS-NET NetBIOS driver 
with a driver called PCNET, shipped with the iRMX OS. The executable filename 
of this driver is pcnet.exe\ it runs under DOS. 

You must also run both a standard DOS network redirector and an iRMX network 
redirector called netrdr.job. 

The following sections describe how to load this software to make the two OS’s 
network software work together. 

Using PCNET with MS-NET 

MS-NET software includes a configuration file named msnet.ini that you typically 
use to automatically start the MS-NET software. When you install iRMX for 
Windows, the installation software will append new commands to the msnet.ini file 
if it already exists on your machine. The OS installation also includes the 
appropriate MS-NET software, with msnet.ini configured correctly to use PCNET. 
This software is in the /dosrmx directory. 

This section describes the differences between the standard DOS-only version of 
msnet.im and the commands needed to use PCNET with iRMX for Windows, so 
that you can set up the msnet.ini file yourself if necessary. 

The DOS-only version of msnet.ini includes statements like the following. 
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start rdr $1 

netbios c:\net\config.nia 
minses 

redir /1:10 /s:10 /Pl:4096 /P2:4096 /P3:4096 /Z:1024 /B:10 
setname $1 
start srv $1 
netbios 
minses 
setname $1 
share 
psprint 

server /i: /s: /n;-l /mb;-l /f;-l /o:-l /c:-l /1:-1 

These DOS-specific entries allow you to start the MS-NET client software with the 
command net start rdr <machine-name> and to start the server with the 
command net start srv <machine-name>. 

To use PCNET with the iRMX OS, add the following commands in the msnet.ini 
file. Notice that these iRMX-specific commands replace the netbios driver with 
pcnet.exe. 

start netrdr $1 
pcnet 
minses 

redir /1:10 /s:10 /Pl:4096 /P2:4096 /P3:4096 /Z:1024 /B:10 
setname $1 
start netsrv $1 
pcnet 
minses 
setname $1 
psprint 

server /i: /s: /n;-l /mb;-l /f;-l /o:-l /c:-l /1:-1 

These iRMX-specific entries allow you to start the MS-NET client software with 
the command: 

net start netrdr <machine-name> 

iS> Note 

The iRMX-specific entries also allow you to start the MS-NET 
server software with a net start netsrv <machine-name> 
command. However, there is no point in starting the MS -NET 
server on a system that runs iRMX for Windows, because the 
server software runs constantly on the DOS OS, which negates 
the value of running DOS together with the iRMX OS. 
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PCNET Configuration 

You can add the following switches to the pcnet line in msnet.ini to change the 
default configuration of the PCNET driver (the s and c options may be upper- or 
lower-case): 

/ s : <sessions> 

Where <sessions> is the number of NetBIOS sessions supported. 
The default value is 6. 

/ c : <commands> 

Where <commands> is the number of NetBIOS commands that can be 
queued to the NetBIOS driver simultaneously The default value is 12. 


Network Redirector Software 

To use the PCNET driver you must run both an iRMX and a DOS network 
redirector: 

• The iRMX network redirector is netrdr.job, which you load under the iRMX 
OS from the :config:loadinfo file, as described in Chapter 4. 

• The DOS network redirector is redir.exe, which runs under DOS and is 
invoked by the redir line in the msnet.ini file. 

There are different versions of the DOS redir file, for specific versions of DOS. 
These are typically installed with DOS, but the iRMX installation also provides 
these files in the /dosrmx directory. Copy the appropriate file listed below to the 
filename redir.exe and put it in a directory that is on your DOS PATH. 


Filename 

DOS Version 

redir.500 

5.0 and 6.x 

redir. 401 

4.01 

redir.400 

4.0 

redir.330 

3.3 

iS> Note 


If you use redir on a DOS 6.x system, you must load setver.exe in 
your C:\autoexec.bat file before loading redir.exe. 

See also: Your DOS manual for more information about these 

files 
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PCNET and NetBIOS Technical Details 


The PCNET driver implements IBM's NetBIOS specification using iNA 960 
Transport and Data Link functions. PCNET is a Terminate and Stay Resident 
(TSR) program that receives NetBIOS interrupt 5CH. 

NetBIOS applications produce Network Control Blocks (NCBs) at software 
interrupt 5Ch with ES:BX pointing to the NCB. PCNET translates NCBs into iNA 
960 Request Blocks and issues a software interrupt 5BH with ES;BX pointing to 
the Request Block. 

The iRMX netrdr.job takes over interrupt 5BH so it can send and receive Request 
Blocks between PCNET and the iNA 960 job running under iRMX for Windows. 

The result is that PCNET redirects NetBIOS commands originating from DOS or 
Windows to the transport services provided by the iNA 960 job. 

Steps to Load DOS and iRMX Network Software 

Eollow these steps in order: 

1. Set up the msnet.ini file and redir.exe file as described in previous sections. 

2. Enable loading of the appropriate iNA 960 job in the iRMX :config:loadinfo 
file. 

See also: i*.job. Chapter 4 

3. Enable loading of netrdr.joh and the iRMX-NET Server job, rnetserv.job, in 
the :config:loadinfo file. (You can also load the client remotefd.job, but it is 
not necessary.) 

4. Enter the iRMX-NET server name in the /net/data file so it will be established 
when iRMX for Windows boots. (This is the name you will use in the net 
use command in Step 1 1 below.) 

See also: /net/data file, Network User’s Guide and Reference 

5. In one of the iRMX files that runs at boot time, such as :config:r?init or 
r?init2, establish public directory names for each iRMX volume you want to 
access from DOS, using the offer command. Don’t offer the names until 
iRMX-NET is running. Example commands are: 

offer : c_rmx : as rmx_wini 
offer :ram: as ramdisk 

6. Also establish public names for DOS volumes that you want to be available to 
other systems across the network. Eor example, if the iRMX system device 
(:sd:) is on a DOS-format drive: 

offer :sd: as sd 
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7. From the iRMX OS, give World user access to the files and directories on the 
iRMX volumes so that DOS users can access them. For example; 

traverse :c_rmx: permit * drau u=world 

Any file or directory not given World access will not be visible from DOS. 
Also, files on iRMX volumes that violate the DOS 8.3 filename convention 
will not be visible from DOS. 

8. Remove all iRMX-NET public directories that refer to directories on DOS 
(EDOS file driver) volumes using the remove command. Eor example: 
remove :work: 

iS> Note 

Do not remove public names for DOS volumes; only the public names 
for directories on those volumes. 

9. Reboot the system to load iRMX for Windows and its network jobs. 

10. Once the iRMX-NET network software has been loaded with the steps above, 
you can start the MS-NET software that loads PCNET, using this command at 
the DOS prompt or in a batch file: 

net start netrdr <machine-name> 

Where <machine-name> is a network name for the DOS network node, and is 
different from the iRMX-NET server name. 

1 1 . Erom the DOS side of the system you should be able to access files on the 
iRMX volume through the network. Eor example, with this command: 

net use g: \\rmxserver\world 

all files and directories on drive G: with World access that use the DOS 8.3 
naming convention are accessible from DOS or Windows. (See also Step 4 
above.) 

This procedure also enables the DOS Load Client (DEC) or Windows Load Client 
(WLC) to launch programs on the iRMX OS. 

See also: DEC and WLC, Programming Techniques 

Checking PCNET Programmatically 

DOS or Windows applications that use the NetBIOS interface provided by the 
PCNET driver should verify that PCNET has been loaded before trying to use its 
services. To verify this, issue a software Interrupt 2EFI, with the value 0B951FI in 
the AX register and OFI in the BX register. If PCNET is loaded, the BX register 
will change to a value of IFI. If not, BX remains unchanged. 
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PCNET Limitations 


On Multibus I and II systems, NetBIOS receive datagrams do not work. 

On a Multibus II system, if a PC-compatible board running PCNET is individually 
rebooted with a <Ctrl-Alt-Del>, PCNET will report a system error when it tries to 
restart. The problem is that the Name Server running on another board (for 
example, an SBC 486/133SE or MIX 560) has not also been reset. PCNET 
attempts to establish the PC node name with a setname command. The Name 
Server already has that name cataloged and will not allow it to be cataloged again. 
If you perform a deletename of the PC node name on the iRMX server before 
rebooting the PC, this problem does not occur. If you do not delete the name and 
ignore the error, the network redirection may work properly. However, in this case 
you should reboot the whole system, not just the PC-compatible board. 

If you attempt to load the DOS-specific NetBIOS driver instead of PCNET, after 
starting iRMX network software, you will receive a file server error and the system 
may encounter a GP fault. This would happen if you entered the command 

net use rdr 

instead of the correct command to load PCNET ; 

net use netrdr 

after modifying the msnet.ini file. If you load the DOS-specific NetBIOS driver 
instead of PCNET and then try to start iRMX for Windows, the PC may hang. You 
may need to do a cold reboot (not <Ctrl-Alt-Del>) to properly restart the system. 

If you do not remove all public directories on DOS volumes from the iRMX OS, 
the system will hang or have a GP fault when you attempt to connect to the 
iRMX-NET server from DOS. 


System Configuration and Administration 


Chapter 3 


53 



Other iRMX Networking Options 

The iRMX OS offers a number of other networking options that work with the 
basic iRMX network software covered here. These include TCP/IP and NFS, 
which also require an underlying iNA 960 job on iRMX systems. You can also use 
DOS networks with iRMX-NET on an iRMX for Windows system. 

See also: For more on iRMX for Windows networks, see netrdr.job, Chapter 4, 

and networking. Programming Concepts for DOS and Windows', 
For more on TCP/IP configuration, see posix.job, itcpkern.job, 
mountd.job, nfsfd.job, nfsd.job, and pmapd.job, Chapter 4, and 
TCP/IP and NFS for the iRMX Operating System 


□ □ □ 
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Reference to Loadable 
Jobs and Drivers 


This chapter summarizes the loadable jobs and drivers provided with the OS, and 
provides an alphabetic reference to each. 

Source code for the front-end modules and configuration files for device drivers is 
located under the :rmx:demo directory. Use this source code to modify a driver to 
suit your needs, or as the basis for writing your own loadable drivers. 

See also: Driver Programming Concepts for information on modifying supplied 

driver source modules 

Supplied Loadable Jobs and Drivers 

The OS provides these kinds of loadable jobs and drivers: 

• System jobs, including a variety of network jobs 

• File drivers 

• Device drivers 

The tables that follow are summaries of the jobs and drivers described in this 
chapter, as well as a summary of interrupt encoding between the iRMX OS and 
DOS. The rest of the chapter provides reference descriptions for every loadable job 
and driver mentioned. In the summary tables, these abbreviations are used: 

Abbreviation Meaning 

III iRMX III OS 

RPC iRMX for PCs OS 

RFW iRMX for Windows OS 

MBI Multibus I bus 

MBII Multibus II bus 

PC PC bus (ISA or EISA) 
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System Jobs and File Drivers 

Table 4-1 lists the loadable system jobs and file drivers. Some jobs are similar in 
function to their ICU-configurable versions, except that they operate as child jobs 
of the HI rather than as first-level jobs. 

See also: Configuring System Jobs Using the ICU, Chapter 6 


Table 4-1. Loadable System Jobs and File Drivers 


Job Name 

OS 

Bus 

Purpose 

atcs279.job 

all 

MBIl 

ATCS 279/ARC server job for terminal controller boards 

bootserv.job 

all 

MBIl 

Receives and services requests from clients that boot 
dependently in a Multibus 11 system 

clib.job 

all 

all 

C library functions that can be shared by applications rather 
than being linked to each application 

dosfd.job 

RPC 

all 

Native DOS file system driver 

flat.job 

all 

all 

Support code for flat model applications to make system calls 
and call C Library functions; paging.job is also required 

himem.job 

RFW 

all 

Extended memory and HMA services for DOS and Windows 

i*.job 

all 

all 

Hardware-specific iNA 960 network jobs; for specific job 
names see Tables 4-5 and 4-6 on pages 77 and 78 

itcpkern.job 

all 

all 

TCP/IP network kernel; load an i*.job first 

keybd.job 

all 

all 

Supports the DOS console, including PC keyboards 

mountd.job 

all 

all 

Part of the NFS server that handles client attach requests 

netrdr.job 

RFW 

all 

Network redirector for DOS applications; load after an i*.job 

nfsd.job 

all 

all 

Part of the NFS server that monitors for client requests 

nfsfd.job 

all 

all 

The NFS client/remote file driver for transparent file access 

paging.job 

all 

all 

Manages memory with the processor in paging mode and 
makes available rqv_ system calls for flat model applications 

pcisrv.job 

all 

all 

PCI server for support of SCSI devices 

pmapd.job 

all 

all 

Part of the NFS server that processes port mapper requests 

posix.job 

all 

all 

Provides psh environment required by TCP/IP command-line 
utilities; if used, load before submitting tcpstart.csd 

rbootsrv.job 

all 

all 

Services requests from clients that boot remotely on the LAN 

remotefd.job 

all 

all 

iRMX-NET client/remote file driver for transparent file access 

ris.job 

all 

all 

Lets DOS/Windows applications invoke iRMX applications 

rnetserv.job 

all 

all 

iRMX-NET server for transparent file access 


continued 
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Table 4-1. Loadable System Jobs and File Drivers (continued) 


Job Name 

OS 

Bus 

Purpose 

sdb.job 

all 

all 

System Debugger (SDB), which is aware of OS objects 

smw.job 

RFW 

all 

Required for Standard-mode Windows; load himem.job first 

sskernel 

all 

all 

The kernel part of the Soft-Scope debugger 

ssload 

all 

all 

Loads your application when you use Soft-Scope Remote 

tcpdde.job 

all 

all 

Support job for DDE communications over TCP/IP transport 

x25cli.job 

all 

MBIl 

Client for X.25 networks; uses a MIX board-based server 


Loadable Device Drivers 

Table 4-2 lists the loadable device drivers supplied with the OS. Each driver 
makes available one or more DUIB names. Use the DUIB name in the 
attachdevice command for access to the device. 

iB> Note 

When you load a driver and attach a device under the iRMX OS, 
DOS can no longer use that device. For DOS access, you must 
first detach the device . 


Table 4-2. Loadable Device Drivers 


Driver 

OS 

BUS 

Purpose 

atcsdrv 

all 

MBIl 

Asynchronous Terminal Controller Server (ATCS) terminal 
driver 

comdrv 

all 

all 

Driver for PC COMn serial ports 

drv82530 

all 

all 

Terminal driver for serial ports on an SBX 354 module 

h550drv 

RFW/RPC 

PC 

T erminal driver for a Comtrol HOSTESS 4- or 1 6-channel 
serial controller board in a PC system 

Ipdrv 

RFW/RPC 

all 

Driver for PC parallel ports 

pcidrv 

all 

all 

PCI driver for Multibus II and Adaptec SCSI controllers 

pcxdrv 

RFW/RPC 

PC 

Device driver for the Digiboard PC/X terminal controller board 

pttydrv 

all 

all 

Pseudo-terminal driver for remote login 

ramdrv 

all 

all 

RAM disk driver 

tccdrv 

all 

MBI 

Terminal driver for Multibus I serial controller boards 
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Interrupt Encoding 

For some device drivers you must specify an iRMX encoded interrupt on the 
invocation line. Devices installed in a PC system are typically configured to a 
DOS interrupt request (IRQ). To translate the DOS IRQ to an iRMX encoded 
interrupt, use Table 4-3. The table shows the typical assignment of IRQs in a PC, 
organized according to the programmable interrupt controller (PIC). This table is 
only valid for PC-compatible architectures, and may not be correct if you can 
change the interrupt configuration of your system hardware. 


Table 4-3. DOS Interrupt Requests and iRMX Encoded Interrupts 


Master PIC 

Slave PIC 

DOS IRQ 

Encoded Int 

Typical 

DOS IRQ 

Encoded Int 

Typical 

(decimal) 

(hexadecimal) 

PC Use 

(decimal) 

(hexadecimal) 

PC Use 

0 

8 

Interval timer 

8 

20 

Clock 

1 

18 

Keybd out buffer 

9 

21 

Redirect to IRQ2 

2 

(21)* 

Slave PIC 

10 

22 

Available 

3 

38 

COM2 

11 

23 

Available 

4 

48 

COM1 

12 

24 

Auxiliary mouse 

5 

58 

LPT2 

13 

25 

Coprocessor 

6 

68 

Floppy controller 

14 

26 

Hard disk 

7 

78 

LPT1 

15 

27 

Available 


Boards set for IRQ 2 and IRQ 9 have the same IRMX encoded interrupts, because the PC-compatible 
RQM BIQS redirects IRQ 9 to IRQ 2. 


iS> Note 

Lower-numbered encoded interrupts have higher iRMX priority. 
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iRMX for PCs, iRMX for Windows, iRMX III OS 


atcs279.job 


atcs279.job 

The Asynchronous Terminal Controller Server (ATCS) manages Multibus II 
terminal controller boards. This is a loadable version of the ATCS/279/ARC server 
job. Start this job for each terminal controller board, then start an ATCS device 
driver on all hosts that use the board through the job. 

See also; atcsdrv, in this chapter 

ICU-configurable version of ATCS/279/ARC server job, Chapter 6, 
and Appendix C for details of how to use the job 


Syntax 

sysload /rmx38 6/ jobs/atcs27 9 . job [dev_name] 

Parameter 

dev_name 

The device name that the server job will use as a serial device. If you do not 
specify a name, the default is t82530_0. 

Additional Information 

The ATCS/279/ARC job typically manages the system console. It operates in one 
of two ways: 

• If there is an SBX 279 graphics board on the host where the server is 
configured, the server manages this graphics terminal, with multiple windows 
available for other CPUs on the bus. 

• If there is not an SBX 279 board, the server multiplexes a character-based 
terminal on this host between CPUs on the bus; you switch CPUs with a hot 
key. 


iB> Note 

If the ATCS/ARC Server is configured for the t82530_0 device 
(no SBX 279), tasks at priority 255 do not execute. The 
workaround is to make sure that all application tasks execute at 
priority 254 or higher (numerically lower). 
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atcsdrv 


iRMX for PCs, iRMX for Windows, iRMX III OS 


atcsdrv 

Device driver for Multibus II serial controllers that support Asynchronous Terminal 
Controller Server (ATCS) protocol. You can use this driver to access an ATCS job 
started by another OS on another host board in the system. Otherwise, you must 
download the ATCS software with a dload command before loading this driver. 

See also: dload. Appendix B 

Syntax 

sysload /rmx386/drivers/atcsdrv ( ' board_name ' , board_instance, 

num_channels , duib_id) 


Parameters 


' board_name ' 

The name of the board as recorded in its interconnect space. Enclose the string 
with single quotes. Options are: 


Board Name 

'186/410' 

'186/450' 

'386/258' 

'386/258D' 

'486/1 33SE' 

'486/166SE' 

'MIX386/020' 

'MIX386020A' 

'MIX486020A' 

'386/120' 


Channels 

6 

12 

5 

5 

5 

5 

12 

12 

12 

12 


Comments 

Must download ATCS SW from this board 

Must download ATCS SW from this board 

With SBX 279 module attached 

With SBX 279 module attached 

With SBX 279 module attached 

With SBX 279 module attached 

Per associated MIX450(S) or MPI450(S) 

Per associated MIX450(S) or MPI450(S) 

Per associated MIX450(S) or MPI450(S) 

Specify this or any other CPU board name to access 
an MPI450(S) controller associated with that board. 


board_instance 

A value of 1 (hexadecimal, no H suffix) specifies the first board of this type 
(board_name) from slot 0, 2 the next, and so on. This is not the slot ID. 


num_channels 

The number of serial channels on this board, in decimal. 


duib_id 

A single letter from A - Z. It is placed in the DUIB name for devices attached 
using this instance of the driver. Eor example, if you load the driver for the first 
186/410 board with duib_id = B, and the next with C, the DUIB names available 
for attach are t_atcs_bO through t_atcs_b5 and t_atcs_cO through 
t_atcs_c5. 
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iRMX for PCs, iRMX for Windows, iRMX III OS 


atcsdrv 


DUIB Names 

DUIB names are constructed from duib_id and num_channels: 

t_atcs_<duib_idxnum_channels> 

For example, if there are three MIX450 terminal controllers attached to a 
MIX386/020 board, and you specify A for duib_id and 36 for num_channels, 
the driver makes available 36 DUIB names: t_atcs_aO through t_atcs_a35. 

iS> Note 

When operating from a board that hosts an SBX 279 terminal 
controller, you cannot use the DUIBs provided by atcsdrv to 
access the 279 terminal. Instead use the local 279 DUIB names. 

See also: Table of local 279 DUIB names. Appendix C 

Additional Information 

An ATCS device is a buffered terminal driver supporting block input and output of 
data with solicited and unsolicited messages. The driver has these characteristics: 

• Supports read, write, special, attach_device, detach_device, open, and close. 

• Supports getting and setting terminal data, setting signal characters, setting 
special characters, setting link parameters, and enabling and disabling flow 
control with special. 

• Recognizes baud rates 110, 150, 300, 600, 1200, 2400, 4800, 9600, and 19200. 
If an unsupported baud rate is requested, the driver overrides it with the next 
higher supported baud rate. 

• Supports all TSC features including special-character interrupts, with these 
exceptions. 

_ The buffered-device features not supported are configurable start/stop 
input characters and high/low-water marks. The controller always uses 
XON and XOFF for the start and stop characters, and fixed values for 
high- and low-water marks. 

_ Separate input and output baud rates for a single serial line are not 
supported. 
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atcsdrv 


iRMX for PCs, iRMX for Windows, iRMX III OS 


Multiple hosts can share a single ATCS controller or ATCS/279 server, but 
multiple hosts cannot simultaneously share the same serial line on the controller. 

iS> Note 

If the ATCS driver is configured to strip the parity bit on input 
characters, special characters (07FH and above) are not processed 
properly if they also happen to be signal characters. 
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iRMX for PCs, iRMX for Windows, iRMX III OS 


bootserv.job 


bootserv.job 

An implementation of the MSA bootserver protocol. When a host requests 
bootstrapping, the bootserver reads the dependent second stage from disk and sends 
it to that boot client. The dependent second stage runs on the boot client and issues 
a request to the bootserver to load the target file containing the OS. 

See also; MSA Bootstrap Specification 

Syntax 

sysload /rmx386/ jobs/bootserv. job (conf ig_f ile) 

Parameter 

conf ig_f ile 

The pathname for the bootstrap loader configuration file containing Bootstrap 
Parameter String (BPS) entries. If omitted, the default value /msa/config/bps is 
used. If /msa/config/bps or the specified file does not exist, the bootserver job fails 
to initialize properly. 

See also: Bootserver Job, Chapter 6 

Additional Information 

Bootserv.job is intended for use with the SBC 486DX33 and SBC 486SX25 
embedded workstation boards running iRMX for Windows or iRMX for PCs, so 
that they may act as the MSA bootserver. 

See also; BPS parameters, MSA for the iRMX Operating System 

iS> Note 

When you include client/server jobs in your system (such as 
ATCS, PCI, etc.), the following problem can occur; Since every 
Multibus II board uses a Multibus II broadcast to find the status of 
the boot master and Quasi-Independent master, the message 
queues can fill on bootserver boards. This can lock up the system 
if the bootserver does not flush the messages. To ensure that the 
bootserver runs and can flush the messages, make the priority of 
your application task lower (numerically higher) than the 
bootserver task priority. 

Other workarounds are to use the Master Test Handler to set 
offline any Multibus II boards that will not be booted, or to 
remove them from the chassis. 
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clib.job 


iRMX for PCs, iRMX for Windows, iRMX III OS 


clib.job 

A library of C functions that can be shared by all applications in the multitasking 
environment. 

Syntax 

sysload /rmx386/ jobs/clib. job 

This loadable version of the shared C library layer includes functions for both 
floating-point and non-floating-point applications. It also includes all available I/O 
functions. In ICU-configurable systems, you can either load clib.job or configure 
the C library with the ICU. The ICU makes available smaller versions of the C 
library for applications that do not require certain functions. 

In iRMX for Windows and iRMX for PCs, you can configure some aspects of 
clib.job by changing values in the rmx.ini file. You cannot do this in the iRMX III 
OS; in this case use the ICU version of the C library to set configuration options. 

See also: C Library [CLIB] block. Chapter 5, 

C Library, Chapter 6, 

Function descriptions, C Library Reference 

Configuring Environment Variabies 

The C library supports environment variables using the getenv and putenv 
functions. A single environment applies to all tasks and jobs sharing the C library. 
The environment context is not maintained on a per-task or per-job basis. The 
application's environment is set up on the first call to getenv by the application. 

You can configure environment variables in the :config:r?env file, using the form: 

environment_variable = ascii_value 

Each entry is on a separate line, terminated by a carriage-return/line-feed character. 
Spaces are required around the equals sign (=). The default :config:r?env file 
contains a string specifying the Pacific standard and daylight time zones: 

TZ = PST8PDT 

The internal environment table can hold up to 40 environment variables. For each 
entry the maximum- length variable name is 16 characters and the maximum-length 
value is 80 characters. 

See also: getenv, putenv, C Library Reference 
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iRMX for PCs, iRMX for Windows, iRMX III OS 


comdrv 


comdrv 

Terminal drivers for the COMm serial ports on a PC. Invoke the sysload command 
once for each driver to be loaded. 

Syntax 

sysload /rmx386/drivers/coindrv (port, io_addr, encoded_int) 

Parameters 

port The number of the COM port; for example, 3 specifies COM3. 

io_addr 

Base I/O address (in hex, no H suffix) used by this COM port. Specify the value 
used in the setup of the hardware. 

encoded_int 

An encoded interrupt, indicating the interrupt level configured for this port. This is 
a hexadecimal byte value (not ending in H) encoded as shown in Table 4-3 on 
page 58. 

DUIB Names 

com1 com2 com3 com4 

Additional Information 

In iRMX for Windows and iRMX for PCs, support for the COMl and COM2 serial 
ports is built in, with these default values: 

Port I/O Address DOS IRQ iRMX Encoded Interrupt 

COMl 3F8H 4 48H 

COM2 2F8H 3 38H 

If you use only these two ports, and they are set to the I/O addresses and interrupts 
shown above, you do not need to load comdrv. If your hardware ports for COMl 
and/or COM2 are configured differently, load comdrv and specify the correct 
values. To add support for a COM3 or COM4 port, load comdrv for those ports. 

PC systems may assign COM3 to the same interrupt as COM 1 , and assign COM4 
to the same interrupt as COM2. Comdrv does not support this; each COM port 
must be set to a different I/O address and interrupt. 
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comdrv 


iRMX for PCs, iRMX for Windows, iRMX III OS 


In the iRMX III OS, this driver can only be used for the SBC 486SX25 or 
486DX33 board. Load the driver to support the COMI and/or COM2 serial port, 
overriding the ICU settings for these ports (ENC parameter on the IDEVS screen). 

Hardware Information 

This driver is for serial ports using an NSI6450 or compatible component. The 
driver communicates directly between the adapter(s) and the iRMX BIOS. The 
driver is not buffered; characters are transmitted or received one at a time. The 
driver has these characteristics. 

• Modem Control; The default is no modem. If you configure the driver for a 
modem, the driver signals Data Terminal Ready (DTR) and RTS when a unit 
attaches. It also passes ring-interrupt or carrier-loss indicators to the TSC from 
the communications adapter. The DTR signal clears or asserts on an Answer 
or Hangup request from the Terminal Support Code. When a unit detached, 
the driver clears DTR and RTS. 

See also: Configuring terminals for a modem. Chapter 2 

• Baud; The driver does a band-rate search when a unit is attached; it recognizes 
1 10, 150, 300, 600, 1200, 2400, 4800, and 9600. It supports 19200 baud rate if 
the particular communications adapter supports it, but cannot detect the 19200 
rate automatically. You must explicitly set a 19200 baud rate in the UINEO 
table for the device. The output and input baud rates are always the same. 

• Parity: The default is 8-bit, no parity. If parity checking is enabled, the driver 
sets or clears the most significant bit of the received character when an error is 
detected. The action depends on the binary value of bits 4 and 5 in the 
terminal_f lags field of the driver's UINEO table. To change these bits: 

— In ICU-configurable systems, use the ICU to change bit values in the 
Serial Driver's IPC, OPC, RPC, and WPC parameters. 

— Change settings programmatically with the special system call or 
dynamically using Operating System Command (OSC) sequences. 

— Rebuild the loadable driver with these bits set. 

See also: Making a device driver loadable. Driver Programming Concepts 
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iRMX for PCs, iRMX for Windows, iRMX III OS 


comdrv 


iS> Note 

If you use this driver for modem support, the following problem 
can occur. If a user logs in with this driver and the phone 
connection is dropped for some reason, the HI session is not 
deleted and the user is not logged off. The next person to dial in 
at the port is not prompted for any logon information but is 
instead returned to the earlier session started by the previous user. 
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dosfd.job 


iRMX III, IRMX for PCs 


dosfd.job 

Loadable version of the native DOS file driver. The native DOS file driver allows 
iRMX for PCs to read and write DOS volumes. 


Syntax 

sysload /rmx386/ jobs/dosfd. job 


DUIB Names 

Name 

A 

AH 

AM 

AMH 

AMO 

B 

BH 

BM 

BMH 

BMO 

C DOS thru Z DOS 


DOS Device(s) 

Floppy drive A:, 5.25" low-density 
Floppy drive A:, 5.25" high-density 
Floppy drive A:, 3.5" low-density 
Floppy drive A:, 3.5" high-density 
Floppy drive A:, 3.5" quad-density 
Floppy drive B:, 5.25" low-density 
Floppy drive B:, 5.25" high-density 
Floppy drive B:, 3.5" low-density 
Floppy drive B:, 3.5" high-density 
Floppy drive B:, 3.5" quad-density 
Hard drives/partitions C: through Z: 


See also: Multibus I and II DUIBs, Appendix E, Command Reference 


Additional Information 

The DOS file driver does not recognize DOS volumes formatted by versions of 
DOS before 3.3. This file driver overcomes most of the restrictions DOS places on 
file I/O operations. Files can be renamed to any subdirectory on a volume. 
Directories have a file size associated with them. Directory time stamps are 
updated when a file is created or deleted. File I/O speed is increased considerably. 

You can use the DTP entry in rmx.ini to specify the I/O task priority for dosfd.job. 

A CAUTION 

Do not load this file driver in iRMX for Windows systems. Only 
use the EDOS file driver in iRMX for Windows. 

The DOS file driver also supports all the Multibus I and II DUIBs such as wqf o. 

To use these DUIBs, after loading dosfd.job, specify the dos switch in the 
attachdevice command; for example: 

ad wqfo as q dos 
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iRMX for PCs, iRMX for Windows, iRMX III OS 


drv82530 


drv82530 

A terminal driver that supports the two serial ports on an SBX 354 module. This is 
a loadable version of the same driver that you can configure on the D2530 screen 
of the ICU. 

Syntax 

sysload /rmx386/drivers/drv82530 {encoded_int , 

data_io_addr_a, ctrl_io_addr_a, baudrate_a, 
data_io_addr_b, ctrl_io_addr_b, baudrate_b) 

Parameters 

encoded_int 

An encoded interrupt, indicating the interrupt level configured for the driver. The 
same interrupt applies to both channels. This is a hexadecimal byte value (not 
ending in H) encoded as shown in Table 4-3 on page 58. 

data_io_addr_a 

data_io_addr_b 

The hexadecimal port address of the data ports for Channels A and B, respectively. 

ctrl_io_addr_a 

ctrl_io_addr_b 

The hexadecimal port address of the control/status ports for Channels A and B, 
respectively. 

baudrate_a 

baudrate_b 

The baud rate for Channels A and B, in hexadecimal. 

DUIB Names 

t82530_0 t82530_1 

Additional Information 

Enter all parameters as hexadecimal values. Do not enter an H at the end of the 
values. 
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flat.job 

Provides the entire flat model support code. Load this job along with paging.job to 
support flat model applications. .Once flat.job is loaded, flat model applications 
can make iRMX system calls and C library calls. 

Syntax 

sysload /rmx386/ jobs/flat . job 

Additional Information 

You can load this job at any time the iRMX OS is running. There are no command 
line options for the job. 

Complete support for flat model applications requires the paging subsystem, which 
you can load as paging.job or configure in the ICU as a first-level job. However, 
you cannot flat.job as a first- level job. 

Errors and initialization messages from flat.job are reported in the :confi g.-flat.log 
file. 

See also: Flat Model applications. Programming Techniques 
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hSSOdrv 

A device driver for the Comtrol HOSTESS multi-port terminal controller board 
installed in a PC system. 

Syntax 

sysload /rmx386/drivers/h550drv (num_channels, io_addr, encoded_int) 

Parameters 

num_channels 

The hexadecimal number of serial channels on this board: 4, 8, or 10 (for 16- 
channel support). Do not specify an H suffix. 

io_addr 

The base I/O address (in hex, no H suffix) configured on the HOSTESS board. 

encoded_int 

An encoded interrupt (in hex, no H suffix), indicating the interrupt level configured 
on the HOSTESS board. This is encoded as shown in Table 4-3 on page 58. 

DUIB Names 

t550_0 t550_1 t550_2 t550_3 t550_4 t550_5 t550_6 t550_7 

Additional Information 

This driver supports only HOSTESS boards with UARTs that can be programmed 
to have a 16-byte input EIEO, such as the 16550 component. 

All channels are configured as 9600 baud with 8 data bits, no parity, and 1 stop bit. 
Configure the board by setting switches for the base address and interrupt level. 

See also: Hardware configuration, Installation and Startup 
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For example, on an 8-channel board, if you configure base I/O address 280H and 
IRQ 5, invoke the sysload command as shown below. Then to access the first 
channel of the controller with the logical name :t:, attach it as a physical device: 

sysload /rmx38 6/dr iver s/h550drv (8,280,58) 
attachdevice t550_0 as t p 

iS> Note 

The HOSTESS board's default jumper setting and sysload 
command in loadinfo are for IRQ 5, which might be used by the 
LPT2 parallel port, or a PCLINK or EtherExpress™ board. If so, 
reconfigure the board and change the interrupt value in loadinfo. 
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himem.job 

This loadable job provides extended memory services (XMS) for use by DOS 
applications and Windows. 

Syntax 

sysload [(min, max)] /rmx386/ jobs/himem. job [handles] 

Parameters 

(min, max) 

A decimal number of Kbytes of memory managed by the job. Unlike other jobs, 
min and max must be equal; the default is 256 Kbytes. Approximately 72 Kbytes 
of this memory is used by himem.job, and is not available as extended memory. To 
encapsulate Standard-mode Windows, smw.job requires at least 1 Mbyte of 
memory; the minimum value you can set for min and max to enable is 1096. 
handles 

A decimal number of memory handles managed by himem.job for DOS 
applications. The default is 32. The maximum is 128. If you specify more than 
128 handles, the job allocates 128. 

Additional Information 

If the sysload command is unable to allocate the minimum memory pool, it fails 
and returns an E_MEM error message. 

Eor example, this command allocates 1096 Kbytes of memory (1 MByte of 
extended memory and 72 Kbytes overhead) and 50 memory handles: 

sysload (1096, 1096) /rinx386/ jobs/himem. job 50 

This job conforms to the Intel/Lotus/Microsoft/ AST XMS 2.0. It deviates from the 
XMS standard in that HIMEM runs as an iRMX job instead of a DOS device 
driver. This is necessary because the iRMX OS controls extended memory and 
extended memory services. 

Table 4-4 lists the XMS functions supported by this job. Eunctions relating to 
upper memory blocks (UMBs) and local handling of the A20 line are not 
supported. 

See also; Configuring DOS, Installation and Startup 
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Table 4-4. XMS Functions Provided by Himem.job 


Function Description 

Function Description 

OH 

Get XMS version number 

9H 

Allocate extended memory block 

1H 

Request high memory area 

OAH 

Free extended memory block 

2H 

Release high memory area 

OBH 

Move extended memory block 

3H 

Global enable A20 

OCH 

Lock extended memory block 

4H 

Global disable A20 

ODH 

Unlock extended memory block 

7H 

Query A20 state 

OEH 

Get EMB handle information 

8H 

Query free extended memory 

OFH 

Reallocate extended memory block 
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i*.job 


i*.job 

There are several iNA 960 jobs that provide a programmatic interface to the ISO 
transport software. The jobs are specific to a system bus architecture because each 
bus requires different Network Interface Card (NIC) hardware. The iNA 960 jobs 
are referred to collectively as i*.job. 

To add iRMX-NET transparent file access and a user interface, load remotefd.job 
and/or rnetserv.job in addition to the appropriate i*.job. 

See also; Network User's Guide and Reference for information about the 
programmatic interface to these jobs and about using subnet IDs 


Syntax 

sysload /rmx386/ jobs/i*n. job 

sysload /rmx386/ jobs/i*e . job [ SNIDl=xxxxH] ... [ SNID4=yyyyH] 

sysload /rmx386/ jobs/ipcl2 . job (io_addr, encoded_int, mem_addr) 

iS> Note 

The Null2 (non-routable) iNA 960 jobs do not have command- 
line parameters. The ES-IS (routable) jobs allow you to set the 
subnet ID(s). Eor the ipcll.job you set specific parameters to 
match the PCL2(A) board. Choose the appropriate job name 
from Table 4-5 on page 77 or Table 4-6 on page 78. 

If the system hangs when you load one of these network jobs, you 
may need to add memory. 

Parameters 

SNIDl=xxxxH 

Eor ES-IS jobs (see jobs that end in “e” in Table 4-6), you can specify the subnet 
ID(s) the job will use. Specify only as many SNID parameters as the job has 
subnets. Eor example, i2mxmpe.job in Table 4-6 has 3 subnets: the first two apply 
to the first two MIX 560 boards and the third applies to the Multibus II subnet. The 
default configuration for the job assigns subnet IDs 1, 2, and 3 to these subnets. To 
change the subnet IDs, specify three SNID parameters; for example: 

sysload /rmx38 6/ jobs/i2mxmpe . job SNID1=0004H SNID2=00FEH SNID3=0001H 

Separate multiple parameters with spaces. The SNID part must be capital letters. 
Always specify a four-digit value followed with H. 
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io_addr 

For ipcll.job only, the I/O port address configured on the board, specified in 
hexadecimal but not ending in H. The default address for the PCL2(A) boards is 
360 (hex). 

See also: Table 4-7 on page 79 

encoded_int 

For ipcll.job only, an encoded interrupt, indicating the interrupt level configured 
on the board. This is a hexadecimal byte value (not ending in H) encoded as shown 
in Table 4-3 on page 58. The default value for the PCL2(A) boards is 21 (hex), 
corresponding to IRQ 2. 

See also: Table 4-7 on page 79 

mem_addr 

For ipcll.job only, the base memory address in DOS I/O space where the board 
communicates. This is the beginning physical address of an 8K block (2000H) that 
cannot be used by any other device (video card, etc.). Enter a five-digit 
hexadecimal value ending in 0; do not specify the FI. A typical value is CCO 0 0. 

Additional Information 

Choose a job to match your computer's hardware and software configuration: 

• COMMengine or COMMputer environment 

• Operating system and bus type 

• NIC, or multiple NICs for jobs that act as routers between subnets 

Network Jobs for the COMMengine 

The iNA 960 MIP jobs run in a COMMengine environment, which means iNA runs 
on a separate NIC from the board that hosts the OS and other programs. The MIP 
jobs in Table 4-5 run on the CPU board with the OS. The NIC can be one of these: 

• A separate Ethernet controller, in which case one CPU board using that NIC as 
a COMMengine must load the appropriate iNA 960 download file on the NIC 

• A CPU board running one of the iNA 960 COMMputer jobs; CPU boards using 
that NIC (the COMMputer) as a COMMengine do not download a file to it 

To control downloading of an iNA 960 file, specify the NIC and the name of the 
download file as parameters in the rmx.ini file (iRMX for Windows or PCs) or the 
BPS file (iRMX III on a Multibus II system). Table 4-5 lists the NICs supported by 
the MIP jobs and the default download files for particular boards. The question 
mark (?) in the filenames represents either an N or an E to specify whether network 
routing is possible. 
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i*.job 


See also: [MIP] block, Chapter 5, 

rq_mip_xx BPS parameter, MSA for the iRMX Operating System 
MIP, Null2 and ES-IS, Network User's Guide and Reference 


Table 4-5. iNA 960 COMMengine Jobs (NIC is Different Board from the OS) 


Job 

OS 

NIC 

Download File 

Bus Type/Comments 

ipcl2.job 

RPC or 
RFW 

PCL2 

PCL2A 

INAPCL27.32L 

INAPL2A7.32L 

PC 

i552a.job 

III 

552A 

INA552A7.32L 

Multibus 1 

icemb2.job 

all 

186/530 
M 1X386/560 
any Multibus II 
COMMputer 

INA5307.32L 

INA5607.32L 

none 

Multibus II 

No MSA firmware on baseboard 
* Separately-loaded iNA 960 


? Specify N for Null2 (no routing capability) or E for ES-IS routing 

* Do not download an iNA file if the MIP job uses an iNA 960 COMMputer board as a NIC 

RPC iRMX for PCs OS 

RFW iRMX for Windows OS 

III iRMX III OS 

A CAUTION 

If you use a MIP job in a Multibus II system and the NIC used as 
a COMMengine fails, the MIP job does not receive any 
notification. If this occurs, software that runs on the board 
running the MIP job will hang when it attempts to make network 
requests. 

Do not use i552a.job on a board where the OS or the application 
runs above 16 Mbytes. The MIP job for the 552 A board cannot 
send iNA 960 request blocks to addresses on the host board of 1 6 
Mbytes or above. For a configuration with more than 16 Mbytes, 
use an SBX 586 board and the appropriate iNA 960 COMMputer 
job. 
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Network Jobs for the COMMputer 

A COMMputer environment means the iNA 960 job runs directly on a host CPU 
board that includes LAN hardware. Table 4-6 lists the NICs supported by these 
jobs. The question mark (?) in the filenames represents either an N or an E to 
specify whether network routing is possible. Jobs with more than one subnet act as 
routers between subnets, using the multiple NICs indicated in Table 4-6. 

See also: COMMputer jobs, Null2 and ES-IS jobs, and Multibus II subnet. 

Network User's Guide and Reference 


Table 4-6. iNA 960 COMMputer Jobs (NIC is Same Board as the OS) 


Job 

OS 

SN 

NICs (and Default Subnet IDs) for 1st, 2nd, 3rd, 4th Subnet 

PCs 

iethpro? 

RPC/RFW 

1 

EtherExpress PRO/1 0 (10 Mb) (1) 

iethxp? 

RPC/RFW 

1 

EtherExpress 16 (1) 

i486hid? 

RPC/RFW 

1 

LP486 PC, onboard 825x6 chip (1) 

inlatn.job 

RPC/RFW 

1 

short-circuit inbox network, no NIC (1) 

Multibus 1 Boards 

i386SX? 

RPC/RFW 

1 

SBC 386/SX using SBX 586 (J7 connector) (1) 

isbx586? 

III 

1 

SBX 586 on any other CPU board (1) 

inimbi .job 

all 

1 

short-circuit inbox network, no NIC (1) 

Multibus II Boards 

i486133? 

III 

1 

SBC 486/1 xxSE(1) 

ihisxe 

III 

2 

SBC 486/1 xxSE (1), SBX 586 (2) 

ihimpe 

III 

2 

SBC 486/lxxSE (1), MB II backplane (2) 

ihisxmpe 

III 

3 

SBC 486/lxxSE (1), SBX 586 (2), MB II backplane (3) 

imix560? 

III 

1 

1 MIX560(1) 

imxmpe 

III 

2 

1 MIX560 (1), MB II backplane (2) 

i2mxe 

III 

2 

2 MIX 560s (1,2) 

i2mxmpe 

III 

3 

2 MIX 560s (1,2), MB II backplane (3) 

i3mxe 

III 

3 

3 MIX 560s (1-3) 

i3mxmpe 

III 

4 

3 MIX 560s (1-3), MB II backplane (4) 

iewexp? 

all 

1 

SBC 486DXxx with EWENET module (1) 

ieimpe 

all 

2 

SBC 486DXXX with EWENET (1), MB II backplane (2) 

ieproe2? 

all 

1 

SBC P5090(1) 

ie2mpe 

all 

2 

SBC P5090 (1), MB II backplane (2) 

imp? 

all 

1 

MB II backplane only (1) 

inlmb2.job 

all 

1 

short-circuit inbox network, no NIC (1) 


SN Number of subnets in this job 

? Specify N for Null2 (no routing capability) or E for ES-IS routing 

RPC/RFW iRMX for PCs and iRMX for Windows OS 
III iRMX III OS only 
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Network Jobs That Run Without Network Hardware 

Table 4-6 lists these network jobs that support short-circuit local network 
communications: 

inlatn.job 

inlmbln.job 

inlmb2n.job 

Using these jobs, an application on a PC or Multibus I system can communicate 
with other jobs in the same system. In a Multibus II system, applications can 
communicate on the same board or between boards in the system. Load these jobs 
to support DDE and ISO transport applications that operate only on the local 
computer. 

Unlike other network jobs, there is no load-time configuration for these jobs. 

The following jobs also do not require network hardware. Unlike the calls listed 
above, these jobs offer the advantage of using the Multibus II subnet, which means 
you can run TCP/IP on multiple boards in the system. 

impn.job 

impe.job 

Configuration for a PCL2(A) board 

Table 4-7 lists the jumper settings for the PCL2 and PCL2A boards. The first 
listing for each board is the default setting. Use the appropriate values in the 
io_addr and encoded_int parameters for ipcll.job. 


Table 4-7. Jumper Settings for the PCL2 and PCL2A Boards 


Board 

I/O Addresses 
Jumpers Address 

Interrupts 

Jumpers IRQ Encoded Interrupt 

PCL2 (default) 

E2 - E3 360 (hex) 

E1 - E2 3C0 (hex) 

E11-E12 2 21 (hex) 

E10-E11 5 58 (hex) 

PCL2A (default) 

E2 - E3 360 (hex) 

E1 - E2 368 (hex) 

E11-E12 2 21 (hex) 

E10-E11 5 58 (hex) 

E13-E14 4 48 (hex) 

E14-E15 3 38 (hex) 
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itcpkern.job 

The loadable TCP/IP network kernel, which makes it possible to run TCP/IP 
applications like FTP and Telnet. 

Syntax 

submit /etc/tcpstart . csd 

Additional Information 

TCP/IP supplies its own submit files in the /etc directory. The network startup 
script tcpstart.csd starts itcpkern.job and tcpstop.csd stops it. The sysload 
commands in those files do the setup and cleanup required by TCP/IP. You can 
run these scripts from the command line to stop and restart the network without 
rebooting the OS. 

Before you start itcpkern.job'. 

1. Load the appropriate i*.job for your system and load the shared C Library job. 

2. Initialize any terminals that will be used with Posix, including the pttydrv 
pseudo-terminal driver. 

See also: Adding a terminal, TCP/IP and NFS for the iRMX Operating System, 

Configuring terminals. Chapter 2 

If you use any of the TCP/IP command-line utilities such as Telnet or FTP, you 
must also load the Posix job (posix.job ). You can load Posix before or after 
starting TCP/IP. Posix is not needed if you use only the programmatic (socket) 
interface to TCP/IP. 

TCP/IP installation creates a :config:r?init2 file with this line that automatically 
runs tcpstart: 

submit /etc/tcpstart . csd 

The file r?init2 contains commands that must be executed during HI initialization, 
but after the terminals are initialized. 

Loading TCP/IP significantly increases the time required for booting the iRMX OS. 
If this is a problem, you can disable the tcpstart.csd line in the r?init2 file and load 
TCP/IP separately later. 

To maintain the system or reinitialize the network without rebooting the operating 
system, submit tcpstop.csd and tcpstart.csd at the command line. If you need to 
stop and restart TCP/IP, you do not need to start and stop the Posix job. However, 
you can also stop and restart the Posix job without rebooting the system. 
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itcpkern.job 


See also: posix.job, i*.job, in this chapter, 

TCP/IP kernel job and tcpstart.csd file, TCP/IP and NFS for the iRMX 
Operating System 

Instead of submitting tcpstop.csd, you can unload itcpkern.job after it is loaded by 
invoking the sysload command with the -u switch. 

A CAUTION 

Before unloading itcpkern.job, make sure no TCP/IP daemons are 
running. The tcpstop.csd script provides an orderly shutdown of 
TCP/IP jobs and applications before unloading itcpkern.job. 
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keybd.job 

This job provides the d_cons device (DOS console) for keyboard input and screen 
output. It can be used with 84- and 101-key keyboards. You can specify the 
foreground and background colors, and a screen-saver time limit. 

Syntax 

sysload -w /rmx386/ jobs /keybd. job [(foreground, background, 

ss_delay) ] 


Parameters 

foreground 

Foreground color (in hex, no H suffix) from 0 to F. 

background 

Background color from 0 to 7. Do not set foreground and background to the 
same color. 

ss_delay 

Screen-saver delay in 10 ms increments. If no screen activity occurs in this period, 
the screen contents are saved to a file and the screen blanks. FFFF disables the 
screen saver. 

Color codes are (shades may look different from monitor to monitor): 

Value Color 

0 Black 

1 Blue 

2 Green 

3 Cyan 

4 Red 

5 Magenta/Purple 

6 Brown/Orange 

7 Light Gray 

8 Dark Gray 

9 Light Blue 

A Light Green 

B Light Cyan 

C Light Red 

D Light Magenta 

E Yellow 

F White 

If no parameters are specified, the default is light gray on black (7,0) with no 
screen-saver. 
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keybd.job 


DUIB Name 

d_cons 

Additional Information 

The d_ _cons device is only useful as an HI terminal, so keybd.job must be loaded 
in the loadinfo file and d_cons must be specified in the :config: terminals file. In 
the loadinfo file, unlock d_cons after loading keybd.job. 

In iRMX for Windows, this job provides the console-sharing code that enables you 
to toggle between DOS and the iRMX OS. 

These control codes in the :config:termcap file can enable foreground and 
background colors to be saved, as well as restoration of the previous screen colors 
upon termination of the aedit text editor: 

AFRV = 0B5F; AFNV = OBOA; AFST = 15010B0A; AFEN = 15021503; 

See also: Terminal configuration file, Chapter 2, 

Loading and unlocking terminal devices, Chapter 3, 

Console Output Codes, Appendix A 


System Configuration and Administration 


Chapter 4 


83 



Ipdrv 


iRMX for PCs, iRMX for Windows 


Ipdrv 

Device driver for the LPTl, LPT2, and LPT3 parallel ports. 

Syntax 

sysload /rmx386/ jobs/lpdrv 

DUIB Names 

Ipt1 Ipt2 Ipt3 

Additional Information 

Lpdrv provides an interface between the iRMX BIOS physical file driver and the 
parallel I/O ports in a PC system. The driver has these characteristics: 

• Supports the write, attach_device, and detach_device system calls 

• Accepts the open and close system calls but does no operations for them 

To make the LPT2 port available with the logical name :lpt2:, attach the 
appropriate DUIB name as a physical device: 

attachdevice lpt2 as lpt2 p 
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mountd.job 

The mountd.job operates in conjunction with nfsd.job as part of the NFS (Network 
File System) server (or daemon). Load mountd.joh on the server system; it 
processes requests from NFS clients to attach NFS-shared devices on the server. 
The client requests are received on the server through the Remote Procedure Call 
(RPC) service. 

Syntax 

sysload [-w] : sd: rmx386/ jobs/mountd. job 

Additional Information 

This is one of three NFS jobs necessary for a host to act as an NFS server: 
mountd.job, nfsd.job, and pmapd.job. You can enable loading of these jobs 
automatically when the system boots by editing the /etc/nfsstart.csd submit file and 
the :config:r?init2 file. You must also run TCP/IP, either as a loadable job or a 
first-level job. 

See also: NFS Support and Using NFS, TCP/IP and NFS for the iRMX 

Operating System 

iS> Note 

You can unload this job after it is loaded by invoking the sysload 
command with the -u switch instead of -w. Flowever, it is 
preferable to submit the /etc/nfsstop.csd file to provide an orderly 
shutdown of NFS. 
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iRMX for Windows 


netrdr.job 

The iRMX OS half of a Network Redirector that gives DOS access to the network 
after you load an i*.job. You can also use netrdr.job with inl*n.job, a short-circuit 
version of the network software that runs without a NIC. This gives local DOS and 
Windows tasks access to files on the iRMX volumes of the computer. The DOS 
half of the Network Redirector is pcnet.exe. To make use of the Redirector, you 
must run MS-Net network software under DOS. 

Syntax 

sysload /rmx386/ jobs/netrdr . job 

Additional Information 

When an iRMX network job is loaded, the iRMX OS owns the NIC. The Network 
Redirector enables DOS and iRMX applications to share the NIC and communicate 
with each other. 

After loading the iRMX network job and netrdr.job, start pcnet.exe, a NetBIOS 
driver installed as a resident program under DOS. 

DOS network applications use the standard NetBIOS interface defined by IBM. 

The applications use a Network Control Block (NCB). Pcnet and netrdr.job work 
together to translate the NCB and send it to the iNA software used by iRMX 
network jobs. 

The jobs must load in this order; 

1 . i*.job (under the iRMX OS) 

2. netrdr.job (under the iRMX OS) 

3. pcnet.exe (under DOS, from the reconfigured msnet.ini file) 

See also: itcpkern.job and i*.job, in this chapter 

Using iRMX-NET in a DOS Environment, Chapter 3 
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nfsd.job 

The nfsd.job operates in conjunction with mountd.job as part of the NFS (Network 
File System) server (or daemon). Load nfsd.job on the server system to enable 
sharing directories and files through NFS. 

Syntax 

sysload [-w] : sd: rmx386/ jobs/nfsd. job 

Additional Information 

This is one of three NFS jobs necessary for a host to act as an NFS server; 
mountd.job, nfsd.job, and pmapd.job. You can enable loading of these jobs 
automatically when the system boots by editing the /etc/nfsstart.csd submit file and 
the :config:r?init2 file. You must also run TCP/IP, either as a loadable job or a 
first-level job. 

See also: NFS Support and Using NFS, TCP/IP and NFS for the iRMX 

Operating System 

iS> Note 

You can unload this job after it is loaded by invoking the sysload 
command with the -u switch instead of -w. However, it is 
preferable to submit the /etc/nfsstop.csd file to provide an orderly 
shutdown of NFS. 
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nfsfd.job 

This job provides NFS client services, including the NFS file driver. Load 
nfsfd.job so that you can attach (mount) remote directories on an NFS server. After 
attaching the NFS-shared resources, you can access files on the remote system as if 
they were local. 

Syntax 

sysload [-w] : sd: rmx386/ jobs/nfsfd. job 

Additional Information 

The nfsfd.job is the only NFS job necessary for a host to act as an NFS client. You 
can load this job automatically when the system boots by editing the 
/etc/nfsstart.csd submit file and the :config:r?init2 file. You must also run TCP/IP, 
either as a loadable job or a first-level job. 

See also: NFS Support and Using NFS, TCP/IP and NFS for the iRMX 

Operating System 

iS> Note 

You can unload this job after it is loaded by invoking the sysload 
command with the -u switch instead of -w. However, it is 
preferable to submit the /etc/nfsstop.csd file to provide an orderly 
shutdown of NFS. 
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paging.job 

Starts the paging subsystem, which manages memory with the processor in paging 
mode. This job, together wiihflat.job, support flat model applications produced 
with non-Intel flat model compilers. Also, paging.job makes available the rqv_ 
system calls used by flat model applications. 

Syntax 

sysload /rmx386/ jobs/paging. job [mem_start, mem_end] [, ...] 

Parameters 

mem_start, mem_end 

The beginning and end addresses specifying one or more blocks of physical 
memory that the paging job identity-maps. Specify the addresses in hexadecimal 
without an H suffix. The starting address is always rounded down to the nearest 4 
Kbyte boundary and the ending address is always rounded up to the nearest 4 Kbyte 
boundary. You can define up to eight such memory blocks. The blocks should not 
overlap; a memory block that overlaps a previously defined block will be ignored 
by the paging subsystem. 

iS> Note 

Any blocks that you specify for identity-mapping must be outside 
the range of physical memory managed by the Free Space 
Manager. Specifying memory here does not add it to Free Space 
memory. 

Additional Information 

Identity mapping means that the paging subsystem maps virtual memory to the 
same address as physical memory, so the memory is accessible by applications, 
device drivers, etc. For example, you might define such memory for use as dual- 
port memory for I/O cards. 

If you don’t specify any memory block parameters, the paging subsystem identity- 
maps only the physical memory known to the Nucleus Free Space Manager. 

See also; FSM screen in the ICU for Free Space Manager memory 

Any physical memory that is not either managed by the Free Space Manager or 
identity-mapped by the paging subsystem will not be accessible once paging is 
enabled. 
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You can load paging.job any time while the system is running, or you can instead 
configure the paging subsystem as a first-level job in the ICU. 

The loadable job reports errors and initialization messages to the 
:config:paging.log file. Initialization messages include the identity memory map 
created by the paging subsystem. Check the log file to verify that the actual 
physical memory has been identity-mapped correctly. Entries in the paging.log file 
are similar to this: 

Paging enabled 

Identity mapped physical memory from 00000000 to 007FFFFF 
Identity mapped physical memory from FAOOOOOO to FAFFFFF 

See also: Flat Model applications. Programming Techniques 
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pcidrv 

Device driver for a Peripheral Controller Interface (PCI) Server on a SCSI 
controller board in a Multibus II system or Adaptec SCSI host adapter in a PC 
system. Load this driver once for each instance of a PCI Server in the system. 

Syntax 

sysload /rmx386/drivers/pcicirv ( ' board_name ' , board_instance, 

server_instance, duib_id) 


Parameters 

' board_name ' 

The name of the board to which the SCSI drive is attached and where a PCI Server 
job is running. Enclose the name in single quotes; this is the name of the board as 
stored in its interconnect space. Possible values are '386/258, '386/258D', 

' 486/133SE ' , or 'AT'. The ' AT ' entry assumes an Adaptec 1542/1742 SCSI 
host adapter (1742 must be in 1542 compatibility mode for the device driver to 
function correctly). 

board_instance 

A hexadecimal value (no H suffix) specifying the instance of this board type in the 
system. This is not the slot ID; 1 specifies the first board of the type indicated in 
board_name, counting up from slot 0; and 2 specifies the second such board, etc. 
These values apply to MBII systems. 

server_instance 

The instance of the PCI Server running for this board. 0 specifies the first instance 
and 1 specifies the second. The server instance matches up with the 
server_instance parameter, part of the rmxini_block_name, in pcisrv.job. 

duib_id 

A single letter from A - Z (not case-sensitive) that will uniquely identify the DUIB 
name. Specify A the first time you invoke the driver, B the second time, etc. 
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DUIB Names 

Tables 4-8 and 4-9 list the DUIB names made available with the PCI driver. In 
these DUIB names, substitute the duib_id value from the sysload command for 
the letter D and substitute the appropriate value of SCSI ID for N. 

A set of special DUIB names support partitioned drives; the names have the format 
gscw5_DAMx or gscw5_DNMxEy. In these names substitute D and N values as for 
other DUIB names. The M and E are part of the names. For x and y, substitute: 

X The number of the Master Boot Partition record, in the range 1-4. 

y The decimal number of the Extended Logical Drive, if this is an Extended 
partition. Only Master Boot partitions 2-4 can be Extended partitions. 

See also: rdisk command and Partitioning PCI Drives, Command Reference 


Table 4-8. Hard Disk DUIB Names for pcidrv Driver 


DUIB Name 

Device Type 

SCSI-ID (N) 

Bytes/Sector 

scw_DN * 

Generic SCSI 

2,3, 4, 5 

1024 

gscw5_DN 

Generic SCSI 

2,3,4, 5 

512 

gscw5_DNMx 

Generic Partitioned SCSI 

2,3 

512 

gscw5_DNMxEy 

Generic Partitioned SCSI 

2,3 

512 

gscw DN 

Generic SCSI 

2, 3,4, 5 

1024 

m3170 DN 

Maxtor XT-31 70S 

2,3, 4, 5 

1024 

m4170 DN 

Maxtor XT-4170S 

2,3, 4, 5 

1024 

m4380 DN 

Maxtor XT-4380S 

2,3, 4, 5 

1024 

m8380 DN 

Maxtor XT-8380S 

2,3, 4, 5 

1024 

m8760 DN 

Maxtor XT-8760S 

2,3, 4, 5 

1024 

hp97536 DN 

Hewlett-Packard 97536 

2, 3,4, 5 

1024 

S2300 DN 

Siemens Megafile 2300 

2, 3,4, 5 

1024 

mp1578 DN 

Micropolis 1578 

2, 3, 4, 5 

1024 

q280_DN 

Quantum Pro 40S/80S 

2,3, 4,5 

1024 

wren5_DN 

Wren 5 

2, 3,4,5 

1024 


In DUIB names, D = duib_id\mm the sysload command and N = SCSI-ID. 
Do not format a drive attached with this DUIB name. 


For example, if you load pcidrv twice for two instances of a 486/133SE board: 

sysload /rmx38 6/dr ivers/pcidrv ( ' 4 8 6/ 133SE ' , 1 ^ 0 , A) 
sysload /rinx38 6/dr ivers/pcidrv ( ' 4 8 6/ 133SE ' , 2 , 0 , B) 

You could attach SCSI-ID 2 on the first board with DUIB name scw_a2, and 
SCSI-ID 2 on the second board with DUIB name scw_b2. 
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Table 4-9. Other DUIB Names for pcidrv Driver 


TAPE DRIVES 

DUIB Name 

Device Type 


SCSI-ID (N) 

Bytes/Sector 

wtaDO 


Archive 2125S 


6 


N/A 

OPTICAL DRIVES 

DUIB Name 

Device Type 


SCSI-ID (N) 

Bytes/Sector 

OPTfgigDN 

Maxoptix Tahiti II 


0,1,2,3,4,5 


1024 

OPT1gig5DN 

Maxoptix Tahiti II 


0,1,2,3,4,5 


512 

OPT1650mDN 

Maxoptix Tahiti II 


0,1, 2,3, 4,5 


1024 

OPT1650m5DN 

Maxoptix Tahiti II 


0,1,2,3,4,5 


512 

DISKETTE DRIVES 

DUIB 

Size 

Device Type 

SCSI Adapter 

SCSI-ID 

Density 

Bytes/Sector 

wqfDO 

5.25" 

Teac 55GFR 

NCR ADP-20 

0 

high 

512 

wqfDf 

5.25" 

Teac 55GFR 

NCR ADP-20 

1 

high 

512 

wdfDO 

5.25" 

Teac 55 BV 

NCR ADP-20 

0 

double 

512 

wdfD1 

5.25" 

Teac 55 BV 

NCR ADP-20 

1 

double 

512 

wmfDO* 

5.25" 

Teac 55BV 

NCR ADP-20 

0 

double 

512 

wmfD1* 

5.25" 

Teac 55BV 

NCR ADP-20 

1 

double 

512 

t55 DO 

5.25" 

Teac 55GFR** 

N/A 

0 

high 

512 

t55 D1 

5.25" 

Teac 55GFR** 

N/A 

1 

high 

512 

t55d DO 

5.25" 

Teac 55GFR** 

N/A 

0 

double 

512 

t55d D1 

5.25" 

Teac 55GFR** 

N/A 

1 

double 

512 

t235 DO 

3.5" 

FD-235HF** 

N/A 

0 

high 

512 

t235 D1 

3.5" 

FD-235HF** 

N/A 

1 

high 

512 


In DUIB names, D = duib_id\mm the sysload command and N = SCSI-ID. 

* wmfO/1 diskettes are standard-granularity (320 Kbyte with 128-byte sectors on track 0) and can be read 
only if they are formatted on a Multibus I system with the parameters: 
format :F:disk ms=0 ext=41 They cannot be written to or formatted on a SCSI device. 

** The SCSI adapter is part of this drive. No separate SCSI adapter board is required. 

Additional Information 

iS> Note 

If you are using an Adaptec SCSI host adapter, do not load the 
ASPI (Advanced SCSI Programming Interface) driver that comes 
with the board. It is incompatible with the PCI server and will 
take control of the host adapter, even though the iRMX OS 
intends to use it. 
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The pcidrv driver has these characteristics: 

• Supports read, write, seek, special, attach_device, and detach_device. 

• Accepts open but does no operation for it. 

• Accepts close for disk controllers but does no operations for it. 

For tape drives, close terminates read or write mode. If terminating the read 
mode, the tape advances to the next file mark or the end of tape. If terminating 
the write mode, any pending output completes and writes a file mark before 
completing the close operation. 

The driver supports these subfunctions of the special calls: 

• Format track 

• Get device characteristics 

• Rewind tape 

• Read tape file mark (forward searching only, one or more file marks) 

• Write tape file mark 

• Get bad track or sector information 

• Set bad track or sector information 

• Re-tension tape 

• Return device specific status 

The driver improves hard disk integrity with the seek-on-detach feature, in which 
the disk heads seek to the innermost cylinder (usually the diagnostic cylinder) in 
response to the f_detach_dev command. 

To format a hard disk, either attach it with a device-specific name or with one of 
the gscw_ names. Device-specific DUIBs contain all the information needed to 
format the drive. The gscw_ generic DUIB names query the SCSI drive to get this 
information. To access a drive that is already formatted with the iRMX format 
command, attach it with either a gscw_ or scw_ DUIB name. 
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pcisrv.job 

Loadable version of the PCI server job that directly manages SCSI peripherals. 
Each instance of a PCI Server in the system requires that pcidrv be loaded. The 
PCI device driver exchanges commands and status with the PCI server; the PCI 
server manages all SCSI bus transactions. You can use an ICU-configurable PCI 
server job instead of the loadable job. 

See also: PCI server job, Chapter 6 

Syntax 

sysload /rmx386/ jobs/pcisrv. job (rmxini_block_name) 

Parameters 

r mx i n i_b 1 o c k_n ame 

Unique name for a block of entries in rmx.ini. The entries contain configuration 
information for the Adaptec SCSI controller in use: e.g., base address, interrupt 
level, server instance. The server instance matches up with the 
server_instance parameter in pcidrv. 0 specifies the first instance and 1 
specifies the second. 

If no rmx.ini entry is specified, the default [PCIADl] block is used. A block of this 
type appears in the rmx.ini file for each Adaptec SCSI host adapter installed; if you 
add a second board, you give that block a unique name. Target mode (when one 
SCSI host adapter attempts to communicate with another SCSI adapter) is not 
supported. 

See also: [PCIADl] block, Chapter 5 

Additional Information 

To get the best performance for large sequential I/O transfers, set the PCI direct 
threshold level using the pci command after attaching the device. The direct 
threshold is the level at which the PCI server's buffers are bypassed (data transfers 
directly into your buffers). As a starting point, set the direct threshold to the track 
size of the device. You can then tune it for a particular application with later pci 
commands. For example: 

pci direct :scw: 32768 
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iS> Note 

If you use an Adaptec 1542 controller, its DMA is limited to 
memory transfers with addresses less than 16 megabytes. For 
systems with more than 16 Mbyte of memory, the application 
should allocate I/O buffer space in the lower 16 Mbyte of 
memory and use the pci command to set the direct threshold level 
to 0. Setting the threshold to 0 ensures that PCI does not copy the 
data in its own buffers, which may be above 16 Mbyte. 

Applications requesting I/O services from the controller should 
use this low memory buffer. 

On an iRMX for Windows or iRMX for PCs system, set Nucleus UML 
parameters in the rmx.ini file to block out the memory. 

Create a pointer to the buffer with the rq_create_descriptor system call. 

See also: pci, Command Reference-, 

How to Use the Peripheral Controller Interface (PCI) Server manual 

The only HI commands supported for tape drives are attachdevice, detachdevice, 
backup, retension, and restore. After you issue a backup or restore command, 
the software automatically rewinds the tape. 
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pcxdrv 

Device driver for the Digiboard PC/X terminal controller board installed in a PC 
system. 

Syntax 

sysload /rmx386/drivers/pcxdrv (io_addr, num_channels, duib, 

encoded_int ) 


Parameters 

io_addr 

The base I/O address, specified in decimal as 0, 1, 2, 3, or 4. This parameter has 
no relation to the hardware board number established by jumpers or switches. 

num_channels 

The number (in decimal) of serial ports on the board. The PC/4 board has 4 
channels, the PC/8 board has 8 channels, and the PC/16 has 16 channels. 

duib A number (x) from 0 to 31 decimal that forms the base of the unique DUIB names 
for each instance of this driver. Each pcxdrv driver establishes DUIB (physical) 
names beginning with pcx_tx, are assigned sequentially from this number. Each 
board requires the loading of a new instance of the pcxdrv driver. Support is only 
provided for up to 32 ports, regardless of the number of boards in the system. Eor 
example, four PC/4 boards provide 16 ports, four PC/8 boards provide 32 ports, and 
one PC/16 board and one PC/4 board provide 20 ports. Up to two PC/16, four 
PC/4, and four PC/8 boards are supported. 

Eor example, if num_channel is 4 and duib is 8, duib names are pcx_t8, 
pcx_t9, pcx_tlO and pcx_tll. The sum of the duib and num_channel 

parameters must be less than 32. 

encoded_int 

An encoded interrupt, indicating the interrupt level on the PC/A board. This is a 
hexadecimal byte value (not ending in H) encoded as shown in Table 4-3 on page 
58. The PC/A boards can be jumpered for interrupts IRQ2, IRQ3, IRQ4, IRQ5, 
IRQ6, or IRQ7. Each board must have a unique interrupt level. 

The example invocation below loads the pcxdrv driver as board number 4 with 8 
serial channels from pcx_t 4 to pcx_t 1 1 on interrupt 5. Note that the input is 
both in decimal and hexadecimal. 

sysload /rmx386/drivers/pcxdrv (0, 8, 0, 58) 


System Configuration and Administration 


Chapter 4 


97 



pcxdrv 


iRMX for PCs, iRMX for Windows 


Additional Information 

iS> Note 

This driver does not support the following: 

• Use of the sysload -w switch 

• Daisy-chained PC/X boards 

• User logon sessions initiated by including an entry in the 
:config: terminals file and unlocking the appropriate port after 
loading pcxdrv 

There is a relationship between the interrupt level and ACE I/O port jumper 
settings on the PC/4 board and PC/8 board. Each ACE has a jumper that is used to 
select an ODD or EVEN interrupt. This allows a single board to generate more 
than one interrupt, with specific ACEs generating one or the other interrupt. 
However, the pcxdrv driver does not support more that one interrupt per board. If 
the level is ODD (3, 5, or 7), the I/O ports must have their interrupt jumper set to 
ODD. If the level is EVEN (2, 4, or 6), the I/O ports must have their interrupt 
jumper set to EVEN. 

There are no jumpers on the PC/16 board, however board 0 must be set for an ODD 
interrupt level and board 1 for an EVEN interrupt level. 

A CAUTION 

If the correct interrupt is not set, the PC/V board may not work 
properly. 

Board I/O Addresses 

Each PC/A board contains jumpers and/or switches that set the I/O addresses of the 
board's status register and each asynchronous communication element (ACE). An 
ACE is one serial channel; if it is a PC/4 board, there will be four serial channels 
(ACE chips) on it. 

In every case except the second PC/16 board, the hardware board number must be 
set to 0. If you have a second PC/16 board, use the jumpers to set its hardware 
board number to 1 . 


Table 4-10. PC/4 I/O Addresses 


Board 

Status Port 

Port 0 

Port 1 

Port 2 

Ports 

0 

188 

130 

138 

140 

148 

1 

288 

150 

158 

160 

168 

2 

208 

1B0 

1B8 

ICO 

1C8 

3 

308 

IDO 

1D8 

1E0 

1E8 
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Table 4-11. PC/8 I/O Addresses 


Board 

Status Port 

0 

1 

2 

Ports 
3 4 

5 

6 

7 

0 

188 

130 

138 

140 

148 

150 

158 

160 

168 

1 

288 

1B0 

1B8 

ICO 

1C8 

IDO 

1D8 

1E0 

1E8 

2 

208 

230 

238 

240 

248 

250 

258 

260 

268 

3 

308 

2B0 

2B8 

2C0 

2C8 

2D0 

2D8 

2E0 

2E8 


iS> Note 

The PC/ 16 board contains no address switches. PAL chips are 
used instead to set the addresses. When ordering the PC/16 
board, you must specify a board number of 0 or 1 and that you 
want the PICK OS PAL chips. These are available from 
Digiboard. Consult your PC/16 hardware reference manual for 
more information. 

See also: Terminal Support Code and terminal devices, Driver Programming 

Concepts', 

The PC/X Configuration Manual 
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pmapd.job 

The pmapd.job is an NFS support job that acts as part of the NFS server. Load this 
job on an NFS server system to process client requests. The job waits at a passive 
socket for port mapper protocol requests. When a client request is received, 
pmapd.job determines which service port is being requested. It notifies the 
requester of which port number to use to gain access to the desired service. 

Syntax 

sysload [-w] : sd: rmx386/ jobs/pmapd. job 

Additional Information 

This is one of three NFS jobs necessary for a host to act as an NFS server; 
mountd.job, nfsd.job, and pmapd.job. You can enable loading of these jobs 
automatically when the system boots by editing the. /etc/nfsstart.csd submit file and 
the :config:r?init2 file. You must also run TCP/IP, either as a loadable job or a 
first-level job. 

See also: NFS Support and Using NFS, TCP/IP and NFS for the iRMX 

Operating System 

iS> Note 

You can unload this job after it is loaded by invoking the sysload 
command with the -u switch instead of -w. Flowever, it is 
preferable to submit the /etc/nfsstop.csd file to provide an orderly 
shutdown of NFS. 
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posix.job 

This job provides the psh shell environment required by some TCP/IP commands. 
It must be loaded before using Posix-dependent TCP/IP applications such as ftp, 
telnet, rsh, etc. If you are using only the TCP/IP library functions for a 
programmatic interface to sockets, but not using TCP/IP commands, you do not 
need to start posix.job. 

Syntax 

sysload -w /rmx386/ jobs/posix. job 

Additional Information 

Before you start posix.job, you must fully initialize any terminals that will be used 
with Posix, such as comdrv and the pttydrv pseudo-terminal driver. You must also 
do the following for TCP/IP support, either before or after loading posix.job: 

• Load the appropriate i*.job and the shared C Library job. 

• Load itcpkern.job, typically by submitting the /etc/tcpstart.csd file. 

See also: Adding a terminal, TCP/IP and NFS for the iRMX Operating Systenr, 

Configuring terminals. Chapter 2 
itcpkern.job, i*.job, in this chapter 

If you edit the loadinfo file, make sure posix.job line remains on the last line, after 
the terminal drivers. 

Loading Posix significantly increases the time required for booting the iRMX OS. 
If this is a problem, you can disable the posix.job line in the loadinfo file. 

See also: Posix job and psh command, TCP/IP and NFS for the iRMX 

Operating System 

You can stop and restart the Posix job without rebooting the system. Use this 
command to stop posix.job: 

sysload -u posix.job 
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pttydrv 

Pseudo-terminal driver for remote login, used by network utilities like telnet and 
rlogin. 

Syntax 

sysload -w /rmx386/drivers/pttydrv (num_channels) 

Parameters 

num_channels 

The total number of pseudo-terminals to be installed. To create pseudo-terminals 
for both Telnet and iRMX network applications, make num_channels larger than 
the TCP/IP configuration variable PTMX_NDEV. This creates extra ptty devices 
that are available to iRMX utilities, but not to Telnet or other Posix-based utilities. 

DUIB Names 

ptty_0 ptty_1 ptty_2 . . . 

Additional Information 

Load pttydrv from the loadinfo file. It must load before posix.job. 

The pttydrv driver can provide virtual terminals for all iRMX and network 
commands. This device has no hardware dependencies. The driver communicates 
directly with the TSC and lORS of the iRMX OS. Pttydrv is a buffered terminal 
driver supporting block input and output of data. The driver has these 
characteristics: 

• Modem Control: All connections made to pttydrv are modem type. The 
modem signal states are software emulated. The driver can assert Data 
Terminal Ready (DTR) and RTS when a unit or channel is attached. It also 
passes ring-interrupt indicators to the TSC. The Hangup request from the TSC 
clears the DTR signal. However, when a unit is detached, the driver clears 
DTR and RTS for the unit or channel only. 

• Baud: pttydrv does not provide baud support. 

• Parity: pttydrv does not provide parity bit support. 
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pttydrv 


See also: Making a device driver loadable, Driver Programming Concepts', 

Configuring the telnetd server, TCP/IP and NFS for the iRMX 
Operating System 

A CAUTION 

Do not attempt to unload pttydrv with the sysload -u switch. It 
could cause a general protection (GP) fault. 
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ramdrv 

Creates a RAM disk in memory, optionally loading a data image file into the RAM 
disk. 

Syntax 

sysload /rmx386/drivers/raindrv (size [, load_file] ) 

Parameters 

size A decimal number for the RAM disk size in Kbytes. The minimum size is 
64 Kbytes and the maximum is 9999 Kbytes, subject to free-space memory 
available in the system. 

load_f ile 

The full pathname of a file containing a previously-created data image to load into 
the RAM disk. The size of the data image file must exactly match the size of the 
RAM disk or the load operation will fail. To create the data image file, follow 
these steps: 

1 . Load the RAM disk driver and specify the disk size for the image you will 
create. 

2. Attach the RAM disk and format it with the desired number of files. 

3. Create a directory structure on the drive and copy the desired programs and 
data files onto the drive. 

4. Detach the RAM disk and reattach it with the physical option. 

5. Copy the physical RAM disk image into a file on a hard disk. 

6. Detach the RAM disk, then reload the driver, specifying the same disk size and 
the complete pathname of the data image file. 

DUIB Name 

ramO 
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Additional Information 

To load a 1024 Kbyte ramdrv disk and make it available with logical name :r:, 
enter: 

sysload /rmx386/drivers/raindrv (1024) 
attachdevice ramO as r 

Since no data image file is specified in the sysload command, a warning indicates 
that the RAM disk is not a named volume. To make the RAM disk a named 
volume, enter: 

format :r:disk_name files=num 

Where: 

disk_name An optional 6-character name given to the device 

f iles=num An optional maximum number of files that can be created on the 
drive; the default is 200 if no file information is specified. 

You can load multiple instances of the driver, each with a separate logical name. 
This only works if you perform the following steps while loading each instance: 

1. Use sysload to load the ramdrv driver. 

2. Use the attachdevice command to create a logical device name: for example, 
:r0:. 

3. Format the disk. 

4. Access the newly-formatted device: for example, copy files to it or use the 
attachfile command to create a second logical name. 

5. Begin again at step 1, assigning a different logical name in step 2 than the first 
time: for example, :rl:. 

Access the first disk with logical name :r0: and the second disk with logical name 
:rl: If you do not perform step D before reloading and reattaching the driver, you 
cannot access the :r0: drive. 

In ICU-configurable systems, you can configure the RAM disk in the ICU (with the 
RAM parameter on the IDEVS screen) or load it with this driver. Ramdrv loads 
where memory is available, while the ICU version requires a pre-assigned address 
(base address is the BMA option on the URAM screen, size is the DSZ option on 
the IRAM screen). 

iS> Note 

You can unload this job after it is loaded by invoking the sysload 
command with the -u switch. 
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rbootsrv.job 

The remote boot server, which allows you to boot diskless workstations across the 
network. The board that runs the boot server must also run an iNA 960 job (i*.job). 
It need not run iRMX-NET. 

Syntax 

sysload /rmx386/ jobs/rbootsrv. job SUBSYS_ID=iiH [DEBUG=x] 
[MAX_BOOT=y] [CC_FILE_S I ZE=z ] [MAX_DELAY=w] 

Parameters 


iS> Note 

You must use uppercase letters as shown for parameter names, 
i i The Data Link subsystem ID for this system, as follows: 

Value Data Link for this hardware: 

20H Boards with 82586 component, including first MIX560 board in the system 
21 H SBX 586 board, EWENET module, or EtherExpress 16 
22H Second MIX560 board in the system 

23H Third MIX560 board in the system 

24H 82595TX component, EtherExpress PRO/1 0, SBC P5090 PC-compatible board 

2FH Multibus II subnet 

X The level of debug information to display onscreen (or wherever you direct the 

standard output for this job with the -o option of the sysload command). Specify 
one of the following levels; the default is 0. The levels are cumulative. If you 
specify level 4, the messages from levels 1, 2, and 3 are also displayed and may be 
interspersed with one another as they occur. Use one of these values: 

0 No debug display 

1 Display node names as they are deleted from internal tables. This can mean 
the client successfully booted or it may mean the client did not finish booting 
because the client requests were not received before the timeout expiration. 

2 Display also a message when each client’s first boot request is received. This 
message includes: 

• Ethernet address of the client 

• Class code of the request 

• Which number client this is (Numboot=n) 

• Index into an internal boot table that stores client information; typically 
the index information will not be useful to you 
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3 Display also each filename as it is received from the client. 

4 Display also a message as each packet is received from the client request. 

y Maximum number of clients that can boot simultaneously. The default is 10. Note 

that large numbers of simultaneous boots can also be limited by other factors, such 
as network traffic. 

z Maximum size of the ccinfo file in bytes; the default is 1024. 

w Maximum amount of time to wait between receiving request packets from the 

client, in seconds. The default is 5. If a client request is delayed longer than this 
period, the next request is not honored, because the server has deleted this client 
from its internal boot tables. 

Additional Information 

In previous releases of the OS, the remote boot server was built into the iNA 960 
NMF (network management facility) software. In the current release it is available 
only as a separately loadable job. The remote boot server is not available as a first- 
level job configurable in the ICU. 

The boot server network multitask address is 01 AA 00 FF FF FF. 

See also: Remote Booting, Network User’s Guide and Reference for details 

about remote booting, such as client requests and class codes 
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remotefd.job 

The loadable version of the iRMX-NET client. It consists of the iRMX-NET 
consumer and remote file driver. Load this job to provide transparent file access to 
systems that run the iRMX-NET server. Before loading this job you must load the 
appropriate i*.job for your system. 

Syntax 

sysload -w /rmx386/ jobs/remotefd 

Additional Information 

The iRMX-NET client and server jobs previously contained iNA 960 software. 
They are now separate jobs. You must load iNA 960 (i*.job) separately or 
configure it in the ICU, then load or use the ICU to add iRMX-NET jobs. 

See also: rnetserv.job for the loadable iRMX-NET server, 

ICU-configurable versions of iRMX-NET jobs, Chapter 6, 

Network User's Guide and Reference about using iRMX-NET, 

Writing loadable file drivers. Driver Programming Concepts 

iS> Note 

If you use a loadable version of an iNA 960 job, you must use the 
loadable versions of the iRMX-NET Client and Server jobs. With 
iNA 960 configured into the OS as a first-level job, you can use 
either the loadable or first-level versions of iRMX-NET jobs. 


108 


Chapter 4 


Reference to Loadable Jobs and Drivers 



iRMX for PCs, iRMX for Windows, iRMX III OS 


ris.job 


ris.job 

The Remote Load Server (RLS) job allows the clients dlc.exe (on DOS) and 
wlc.exe (on Windows) to invoke iRMX applications on the server's system. The 
client can be on a remote DOS node or the DOS side of an iRMX for Windows 
node. 

Syntax 

sysload /rmx386/ jobs/rls . job [max_dialogs=num] 

[max_inessages=num] 


Parameters 

max_dialogs=num 

The maximum number of simultaneous client dialogs supported by this server, 1 to 
255. The default is 16. 

max_messages=num 

The maximum number of simultaneous outstanding terminal output messages 
supported by this server. The default is 256. 

Additional Information 

Ris.job requires an iNA 960 job (i*.job) to be loaded. Choose one of these jobs to 
match your networking requirements. On iRMX for Windows, also load iRMX- 
NET jobs, netrdr.job and pcnet.exe if local DOS and Windows users will run 
iRMX applications. To give local DOS and Windows users access to iRMX 
applications on an iRMX for Windows system that is not connected to a network, 
choose inl*n.job-, also load netrdr.job and pcnet.exe. 

You must also register the Remote Load Server with the Name Server. This is 
needed even for local access, because the DOS or Windows client must find the 
iRMX-based server. 

You can establish the server name with the setname command. For example, to set 
it from the command line: 

iRMX> setname servername 

This creates entries under property types 3H (file server) and 5H (host-unique ID), 
as well as 6H (remote load server). To register a node as only a load server, not a 
file server, add the rls object type to the command line: 

iRMX> setname servername rls 
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You normally add the server name to the first line of the :sd:net/data file, so the 
name is automatically loaded into the Name Server at boot time. 

You can also set the name programmatically with the Name Server ADD_NAME 
command. 

See also: i*.job and netrdr.job, in this chapter; 

Using iRMX-NET in a DOS environment. Chapter 3; 
setname and loadname commands. Command Reference, 

Adding objects to the name server object table and 

ADD_NAME command. Network User's Guide and Reference', 
Remote load server, dlc.exe and wlc.exe. Programming Concepts for 
DOS and Windows 
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rnetserv.job 

The loadable version of iRMX-NET server, which provides transparent file access 
to remote systems that run the iRMX-NET client job. Before loading this job you 
must load the appropriate i*.job for your system. 

Syntax 

sysload -w /rmx386/ jobs/rnetsrv. job 

Additional Information 

The iRMX-NET client and server jobs previously contained iNA 960 software. 
They are now separate jobs. You must load iNA 960 (i*.job) separately or 
configure it in the ICU, then load or use the ICU to add iRMX-NET jobs. 

This job catalogs the names RNETSRV and NSDONE in the Name Server object 
table during its initialization. Remote boot (RSD) clients look for these cataloged 
objects so they can coordinate their boot requests with the file server initialization. 
RNETSRV is cataloged at the beginning of initialization; it lets the clients know 
that there is a file server. NSDONE is cataloged after the file server has finished 
adding all the entries from /net/ data file to the Name Server object table. 

Boot clients need to be able to get /net/data information about the file server from 
the Name Server. The RSD client waits for server initialization to complete 
(indicated by NSDONE) only if it finds RNETSRV cataloged. 

See also; remotefd.job for the loadable iRMX-NET client, 

ICU-configurable versions of iRMX-NET jobs. Chapter 6, 

Network User's Guide and Reference for information about 
iRMX-NET and the RNETSRV and NSDONE objects 

iS> Note 

If you use a loadable version of an iNA 960 job, you must use the 
loadable versions of the iRMX-NET Client and Server jobs. With 
iNA 960 configured into the OS as a first-level job, you can use 
either the loadable or first-level versions of iRMX-NET jobs. 
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sdb.job 

The system debugger (SDB) job. 

Syntax 

sysload /rmx386/ jobs/sdb. job 

Additional Information 

The SDB is a debugging tool for iRMX applications and system programs. It can 
display information about OS objects and can interpret iRMX calls and stacks. If 
you use the Soft-Scope debugger, load sdb.job to make SDB commands available 
from within Soft-Scope. 

See also: System Debugger Reference 
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smw.job 

This job must be loaded after himem.job before you start Windows in standard 
mode. This job enables Standard-mode Windows and the iRMX OS to coexist. 

Syntax 

sysload /rmx386/ jobs/smw. job 

Additional Information 

Smw.job encapsulates Standard-mode Windows and runs it as a task under the 
iRMX OS. Before loading smw.job, make available at least 1 Mbyte of extended 
memory by loading himem.job. Allocating more memory improves the 
performance of Windows. When you start Windows in standard mode, it uses all 
the extended memory made available by himem.job, up to 16 Mbytes. 

See also: himem.job 
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sskernel 

The kernel part of the Soft-Scope debugger. You must load sskernel before you 
can invoke either the command line version of Soft-Scope or Soft-Scope for 
Windows. 

Syntax 

sysload /util386/sskernel [com.m_method local] 

sysload /util386/sskernel com.m_method serial 
[serial_port coml | com2 | device_name] 

[serial_baud baudrate] [ work_dir_name directory] 

sysload /util386/sskernel comin_inethod network 

[network_port hex_udp_port] [work_dir_name directory] 

Parameters 

comm_method 

Specify one of the following; the default is local: 

local Soft-Scope Local (for Windows) or the command line version of 
Soft-Scope 

serial Soft-Scope Remote, host and target connected through a serial port 
network Soft-Scope Remote, host and target on a TCP/IP network 

serial_port 

Specify the device name of the serial port sskernel will use on the target machine. 
The default is coml, but you can specify any device being used, such as 

t82530_0. 

baud_rate 

Specify the baud rate at which sskernel will communicate over a serial link. The 
default is 9600. 

network_port 

Specify a hexadecimal port number used by the UDP protocol on the target 
machine. The default is 4321H. 

work_dir_name 

Specify a directory where sskernel stores working files and temporary files on the 
target machine, including Soft-Scope’s .tmp file. The default is :work:. 
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Additional Information 

The sskernel job is installed in the /util386 directory with other Soft-Scope files, 
not in the /rmx386/jobs directory. Instead of using the sysload command, you 
could start sskernel as a background job. However, the job would be removed 
when you logged off the system. Running the kernel as a loadable job makes Soft- 
Scope available for all users on the system. 

You can configure the Soft-Scope kernel as a first-level job with the ICU instead of 
loading it. 

iS> Note 

To use the sskernel job, you must also load clib.job. Otherwise, 
an E_NOT_CONFIGURED error is reported in the 
:utils:sskernel.log file. 

See also; ssload in this chapter 

Chapter 8 in this manual and 

Soft-Scope Local and Remote, Soft-Scope Debugger User’s Guide 
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ssload 

If you use the Remote version of the Soft-Scope debugger and you use the loadable 
version of sskemel (instead of configuring it in the ICU), then you must also load 
ssload. Soft-Scope Remote uses ssload to load an application. Always load ssload 
after sskemel. 

Syntax 

sysload /util386/ssload 
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tccdrv 

Device driver that supports up to eight serial channels in a Multibus I system using 
one of these serial controller boards: SBC 188/48, 188/56, 546, 547, 548, or 549. 

Syntax 

sysload /rmx386/drivers/tccdrv (base_addr, io_addr, encoded_int 

[, mega_page] ) 


Parameters 

base_addr 

The base address (in hex, no H suffix) of the TCC board's dual port RAM, as seen 
from the host CPU. 

io_addr 

The I/O address (in hex, no H suffix) of the TCC board, as seen from the host CPU. 

encoded_int 

An encoded interrupt level used by the TCC board to signal the host CPU when a 
serial channel needs servicing. This is a byte value (in hex, no H suffix) encoded 
as shown below. 

Bits Value 

7 Reserved bit; set to 0 

6-4 First digit of the interrupt level (values 0-7) 

3 If one, the interrupt is on the master PIC and bits 6-4 specify the entire 

number 

If 0, the level is on a slave PIC and bits 3-0 specify the second digit of 
the interrupt level 

3-0 Second digit of the interrupt level (values 0-7), if bit 3 is 0 

For example, if the board is set to interrupt 5 and connected to the master PIC on 
the CPU host, the encoded_int value would be 58, where 5 is the interrupt level 
and 8 indicates the master PIC. 

mega_page 

This parameter is used only for iRMX for Windows or iRMX for PCs, when the 
host CPU is an SBC 386SX or SBC PCP4 board. The parameter is the Mbyte page 
number (O-OFH) where the TCC board's dual port memory actually resides. For 
example, if the TCC board's dual port memory is at physical address 0F90000H, 
specify F when loading the driver. 
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DUIB Names 

t548_0 t548_1 t548_2 t548_3 t548_4 t548_5 t548_6 t548_7 

Additional Information 

Under iRMX for Windows and iRMX for PCs, this device driver supports an 
SBC 386SX or SBC PCP4 host CPU board, with one of the supported terminal 
controller modules. Use the examples below to set up the boards to work with this 
driver. 

SBC 386SX Host 

The SBC 386SX board sees Multibus memory one megabyte at a time, through a 1 
MByte window at memory location ODOOOOOH. The specified address requires 
translation into this window. For example, if the TCC board's memory physically 
starts as 0F90000H, the SBC 386SX board sees it at location 0D90000F1 (if the 1 
Mbyte window is pointed to location OFOOOOOH). 

The host SBC 386SX board also accesses Multibus I/O addresses 0 through 7FFFH 
using I/O addresses 8000H through OFFFFH. Add 8000H to the I/O address 
jumpered on the TCC board. For example, if the TCC board's I/O address is 8A6FI, 
specify address 88A6H. 

All channels on the TCC board are configured as 9600 baud with 8 data bits, no 
parity, and 1 stop bit. Configure interrupts on the TCC and host CPU board by 
setting the appropriate jumpers. 

For example, if you are using an SBC 386SX and an SBC 548 TCC board with 
these characteristics (based on jumpering); 

Parameter Value 

Memory address 0F90000FI 

I/O address 8A6FI 

Multibus Interrupt (MINT) level 3 

The invocation for loading the driver would be; 

sysload /rmx38 6/dr iver s/tccdrv (D90 0 0 0 , 8 8a6 , 2 7 , F) 

To access the first channel of the controller with the logical name :t:, attach it as a 
physical device; 

attachdevice t548_0 as t p 

This example assumes that the SBC 386SX board is jumpered for the default 
hardware configuration. 

See also; Hardware configuration. Installation and Startup 
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SBC PCP4 Host 

To use this driver with an SBC PCP4 board running iRMX for Windows or iRMX 
for PCs, you must configure the board to operate like the SBC 386SX for its dual- 
port memory. The following example sets up the SBC PCP4 board to use the same 
addresses as listed above for the SBC 386SX. The 548 TCC board’s dual port 
memory for this example is at F90000H, its I/O address is at 8A6H, and its default 
Multibus I interrupt is MINT 3. 

iS> Note 

If you run the iRMX III OS on an SBC PCP4 board, you must 
still set up the dual port memory as needed by the TCC. 

However, with that OS you do not use the mega_page parameter 
when you load this driver. 

Most configuration on the PCP4 board is done in BIOS setup routines. However, 
you must set one jumper on the board for this configuration. Set the interrupt for 
MINT 3 to IRQ 15, by placing a jumper on pins E46-E36. 

Then to configure the BIOS setup routines, follow these steps: 

1. Power up the system and when the system first prints to the VGA screen, press 
the <E1> key to enter BIOS setup. 

2. In setup go to the Advanced Screen, then to the Multibus Memory and I/O 
Configuration Screen, and set: 

Protected-Mode Memory Base = D9 
Limit = DA 
Offset = E9 

3. In the same screen go to the I/O window and set: 

I/O window base = 80 
Limit = EB 
Offset = 0 

iS> Note 

This maps the host I/O range 8000H - OEBEEH to match the Multibus 
range OH - 7BEEH on the Multibus bus. This avoids using the I/O 
addresses from OECOOH - OEEEEH, which can be used by SCSI-2 and 
PCI devices on this board. 

4. Press <ESC> to get you out of the screen you are in and go to the Interrupt 
Configuration Screen. Move to IRQ 15 on this screen and set it to “Used by 
ISA/MB”. 

5. Press the <E10> key to exit the BIOS setup and boot the system. 


System Configuration and Administration 


Chapter 4 


119 



tccdrv 


iRMX for PCs, iRMX for Windows, iRMX III OS 


Now the CPU board will see the TCC board's memory at location 0D90000H and 
the I/O address jumpered on the TCC board (for example 8A6H) as 88A6H. 

The invocation for loading the driver would be: 

sysload /rinx38 6/dr ivers/tccdrv (D90 0 0 0 , 8 8a6 , 2 7 , F) 

To access the first channel of the controller with the logical name :t:, attach it as a 
physical device: 

attachdevice t548_0 as t p 
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tcpdde.job 

If you use DDE communications over a TCP/IP network, you must load this job 
before starting the DDE application. 

See also: DDE, Programming Concepts for DOS and Windows 

Syntax 

sysload [-w] /rmx38 6/ jobs/tcpdde . job 

Additional Information 

You must start TCP/IP before this job. The default sysload command for this job is 
in the :config:r?init2 file, which starts it after the TCP/IP kernel. You can also use 
this job with the first-level version of TCP/IP instead of the loadable version. 

There is no first-level version of tcpdde.job. 

iS> Note 

You can unload this job after it is loaded by invoking the sysload 
command with the -u switch instead of -w. 


System Configuration and Administration 


Chapter 4 


121 



x25cli.job 


iRMX for PCs, iRMX for Windows, iRMX III OS 


x25cli.job 

Load this job on any board in a Multibus II system to support an X.25 application. 
You must run the X.25 server on a MIX baseboard; the server can support multiple 
clients. 

Syntax 

sysload /rmx386/ jobs/x25cli . job 

Additional Information 

The X./25 client and server communicate across the Multibus II chassis. The 
server runs on a MIX baseboard that supports certain serial communications 
boards, which you connect to an X.25 network. 

You can use the ICU to set up the X.25 client as a first-level job if you choose not 
to run the loadable version of the client. 

See also: X.25 jobs. Chapter 6 

Chapter 1, X.25 User’s Guide and Reference 


□ □ □ 
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In iRMX for Windows and iRMX for PCs only, you can improve system 
performance with values specified in the rmx.ini file. On reboot, layers of the OS 
load these values as configuration parameters from rmx.ini. 

Load-time Configuration Using the rmx.ini Fiie 

Installing the OS creates the default rmx.ini file, with blocks of entries for various 
parts of the installed system. You change configuration parameter values contained 
in each block, to complete load-time configuration of the OS. For example, you 
can optimize file I/O for your application with rmx.ini settings that increase buffer 
size or I/O task priority. To override preconfigured values: 

• The rmx.ini file must exist in the :config: directory. 

• Values must be specified according to the rmx.ini file syntax, each within 
minimum and maximum limits. 

See also: loadrmx command, -i switch. Command Reference 

For example, if your iRMX for Windows application uses an Intel Embedded 
Workstation board (SBC 486SX25, 486DX33, or 486DX66), make these changes 
in the rmx.ini file: 

• In the [NUC] block, set BUS=02H 

• For iNA 960 MIP support, make these changes in the [MIPxx] block: 

— To use an SBC 186/530, set DN= ' SD ' , LD= ' LOCAL ' , 

FN=' /NET/INA530N. 32L ', and CBN= ' 18 6/530 ' 

— To use an SBC 486/133SE COMMputer, set LD= ' NOLOAD ' and 
CBN='486/133SE' 

— To use a MIX 386/560 board, set DN= ' SD ' , LD= ' LOCAL ' , 

EN=' /NET/INA560N. 32L ', and CBN= ' MIX38 6/5 60 ' 

— To use a MIX 386/020 COMMputer, set LD= ' NOLOAD ' and 
CBN='MIX386/020 ' 
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— To use one of these configurations: 

MIX 386/020 COMMputer 
MIX 486/020A COMMputer 
MIX 486SX33 COMMputer 
MIX 486DX33 COMMputer 

MIX 486DX66 COMMputer with a MIX 560 module 
set LD= ' NOLOAD ' in the [MIPxx] block. 

See also: MIP jobs, Network User's Guide and Reference 

iS> Note 

The [MIPxx] blocks apply only in a Multibus II system, where 
there can be more than one such block and the xx specifies which 
instance of a particular NIC to use. In a Multibus I or PC system 
you use a [MIP] block in the rmx.ini file rather than [MIPxx] 
blocks. 

• For iRMX-NET support, make these changes in the [RNETS] and [RNETC] 
blocks: 

— To use an SBC 186/530, set CBN=' 18 6/530 ' and set CB I to the instance 
of the 186/530 being used as a NIC 

— To use an SBC 486/I33SE COMMputer, set CBN= ' 486/133SE ' and set 
CBI to the instance of the 486/1 33 SE being used as a NIC 

— To use a MIX 386/560 board, set CBN= ' MIX38 6/5 60 ' and set CBI to the 
instance of the MIX 386/560 being used as a NIC 

— To use a MIX 3 86/020 COMMputer, setCBN='MlX386/020' and set C B I 
to the instance of the MIX 386/020 being used as a NIC 


124 


Chapter 5 


Configuring rmx.ini 



rmx.ini File Syntax 

Look at your rmx.ini file. Configuration parameters are within blocks of entries: 

[NAME] 

entry=value ; Comment string 

Where: 

NAME Case-sensitive block name. Configuration parameters follow on each 

new line (no blank lines). A block ends with the beginning of the next 
block or end of file. 

entry Case-sensitive name (1 to 16 characters) for a configuration 
parameter, followed by an equal sign (=). 

value Hexadecimal (with H suffix) value or string (with single quotes), 
followed by a semicolon (;). 

Comments may appear after the semicolon, extending to the end of the line. 

An Example rmx.ini File 

Figure 5-1 shows all of the defined blocks, and default values for entries. The 

exact version of rmx.ini on your system depends on your installed configuration. 

The rest of this chapter describes each entry, including possible values and 

discussion of usage. 
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[NUC] 
UML=OOH; 
0SX=14H; 
RRP=8CH; 
RRT=05H; 
KTR=01H; 
BUS=03H; 
DIB=010000H; 
DOB=010000H; 
DEH=OOH; 
XLLM=??H; 
XLHM=??H; 
CAF=??H; 
NAR=01H; 
LM1=????H 
HM1=????H 
[DISPJ] 
VIE=OOH; 
EPR=OOH; 
CMS=OFFH; 
PMS=OFFH; 
[BIOS] 
GC=03H; 
ADP=81H; 
CON=82H; 
TTP=81H; 
NTP=83H; 
RTP=83H; 
ETP=83H; 
DTP=83H; 
ENE=0FFH; 
EFLC=0FFH; 
[BIOS] 
SBS=0400H; 
PBS=0400H; 
NBS=0400H; 
RBS=0400H; 
EBS=0400H; 
DBS=0400H; 
DDS=032H; 
ADV= ' device. 
AFD=05H; 


Upper Memory Limit 

Number of User OS Extensions 

Round Robin Threshold Level - Real Time Fence 
Round Robin Time Period 
Kernel Tick Ratio 

Bus Type, OlH = Multibus I, 02H = Multibus IT, OSH = PC 
MB IT message passing DMA input alignment buffer size 
MB IT message passing DMA output alignment buffer size 
Default system exception handler is JOB? ( 0H=f alse, 0FFH=true) 
Low address. Exclude from memory reclamation, RPC only 
High address. Exclude from memory reclamation, RPC only 
Clock Adjust Factor (signed number, range OH - OFFFFH) 

Number of Ranges Added to Free Space Memory (1 - 5H) 

Low memory (base of first additional memory range) 

High memory (top of first additional memory range) 

Enable interrupt virtualization 

ESDI drive present (0H=false, 0FFH=true) 

Switch character mode on hardware traps (0H=false, 0FFH=true) 
Video Page switch SHOULD SET SAME AS CMS ( 0H=f alse, 0FFH=true) 

Global Clock Type 
Attach Device Task Priority 
Connection Deletion Task Priority 
Timer Task Priority 

Named File Driver I/O Task Priority 
Remote File Driver I/O Task Priority 
EDOS File Driver I/O Task Priority 
DOS File Driver I/O Task Priority 

Enable Named File Driver Extensions (0H=false, 0FFH=true) 
Force DOS Filenames to Lower Case (0H=false, 0FFH=true) 

Stream File Driver Buffer Size 
Physical File Driver Buffer Size 
Named File Driver Buffer Size 
Remote File Driver Buffer Size 
EDOS File Driver Buffer Size 
Native DOS File Driver Buffer Size 
Default I/O Job Directory Size 
.name'; Default system device name 
File driver for system device 

Figure 5-1. Example rmx.ini File 
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[HI] 

SCF= ' r ?init ' ; Default system configuration file 

TCF= ' terminals ' ; Default terminal configuration file 
JST=1770H; Job synchronization timeout value 

[CLIB] 

NEB=0002H; Number of BIOS buffers per connection 

MBS=2000H; Malloc block size 

[KEYBD] 

TE=0FFH; Enable Alt-SysRq keys {OH-false, OFFH-true) 

DOC=0FFH; DOS owns console on initialization {0H=false, OFFH^true) 

RDA=00H; Disable Ctrl-Alt-Del {0H=false, 0FFH=true) 

MBD=00H; Disable Ctrl-Alt-Brk {0H=false, 0FFH==true) 

[PCIADl] 

LUNOONLY=OFFH; Scan SCSI bus for logical unit 0 only {OH^^false, 

OFFH-true) 

SBT=03H; System Bus {OlH - Multibus I, 02H = Multibus II, OSH = PC) 

BT=040H; Board Type (PC-040H, SBC PCP4=030H, 

; SBC P5090=08H, SBC 486DX66=07H) 

SCSICONTYPE- 022H SCSI Controller {1542/1742=022H, 6360 =023H, 7850 =024H) 

HABASE=0330H; Host Adapter Base Port Address for Adaptec 1542/1742 board 

BASEADDR=00H; Host Adapter Base Port Address for Adaptec 6360/7850 chips 

DMA=05H; DMA Channel used 

CCBS=8; Number of CCBs 

STO=000FAH; Select Time Out 

BONT^4; Bus On Time 

BOFFT-4; Bus Off Time 

BXS=0; SCSI Bus Xfer Speed 

INTL=23H; Host Adapter Interrupt Level 

SIN=0; Server Instance 

RESSCSI-OH; Reset SCSI Bus {OH-false, OFFH-true) 

SCSIID^7; SCSI ID is programmable in the 6360/7850 chips 

[UA] 

CNN= ' rmx ' ; Consumer Name 

CNP=' 1234567 ' ; Consumer Password 

[MIP]; For PC or Multibus I 

DN='SD'; Device Name 

LD=' LOCAL'; iNA Load 

FN= ' pathname ' ; iNA File Name 

CBN= ' boardname ' ; Communication Board Name 

CBI=1H; Communication Board Instance 

[MIPOO]; For Multibus II 

DN= ' SD ' ; Device Name 

LD=' LOCAL'; iNA Load 

FN= ' pathname ' ; iNA File Name 

CBN= ' boardname ' ; Communication Board Name 

Figure 5-1. Example rmx.ini file (continued) 
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[RNETS]; iRMX-NET Server 

CBN= ' boardname ' ; Communication Board Name 
CBI=1H; Communication Board Instance 

[RNETC]; iRMX-NET Client 

CBN= ' boardname ' ; Communication Board Name 
CBI=1H; Communication Board Instance 

Figure 5-1. Example rmx.ini file (continued) 


Nucleus Block [NUC] 

UML Upper Memory Limit 

The iRMX OS can use all available contiguous memory beginning at physical 
address 1 lOOOOH (1 MByte + 64 Kbytes), up through the address specified here. 

Value Meaning 

0, FFFFFFFFH iRMX for Windows controls all extended memory found by the 
ROM BIOS at boot time, up to 64 Mbytes 

Any other value Overrides the amount found by the ROM BIOS memory tests. 

If your system has more than 64 Mbytes of memory, you must 
set UML, typically to the total amount of physical memory 
present in the system. 

Use this parameter to reserve memory in the high address range by setting UML to 
a value lower than the top of memory. For example, memory for an I/O device 
might be mapped to start at COOOOOH (12 Mbytes). To prevent the OS from 
interfering with this memory, you would set UML=BFFFFFH. (See also the NAR 
and LMl, HMl through LM5, HM5 parameters.) 

OSX OS Extensions 

Specifies the number of OS Extensions available for applications. OS Extensions 
used by loadable jobs are not taken from this number. 

The OS reserves a slot in the Global Descriptor Table (GDT) for each OS 
Extension specified here, beginning with GDT slot 440. This reduces the number 
of objects created by application jobs (each object also uses a GDT slot). 

See also: OS Extension example. Programming Techniques', 

rqe_set_os_extension. System Call Reference 

RRP Round-robin Priority (real-time fence) 

Value Meaning 

O-OFEH Tasks below the real-time fence (numerically above priority 

RRP + 1) are scheduled in round-robin fashion, rather than by 
highest priority; 0 works well with priorities of HI, BIOS, and 
BIOS tasks 

OFFH Disables round-robin scheduling 
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RRT Round-robin Time period 

The number of iRMX clock ticks (10 ms) a task runs before being preempted by 
another task. Only valid for tasks whose priority is lower than the real-time fence. 

KTR Kernel Tick Ratio 

The ratio of the Nucleus tick interval (10 ms) to the iRMK tick interval. Possible 
values are 1 (default), 2, 5, 10, or greater than 10. 

A higher KTR value shortens the iRMK clock tick value relative to the 10 ms 
iRMX clock tick as follows: 


KTR Value 

1 

2 

5 

10 (OAH) 
20 04H) 


iRMK Tick 

10 ms 
5 ms 
2 ms 
1 ms 
500 ps 


Never assume that a Nucleus tick is equivalent to an iRMK Kernel tick. You 
should write code that adapts to the KTR values. The iRMK clock tick interval 
affects the create_alarm, get_time, receive_data, receive_unit, set_time, and 
sleep system calls. 


See also: KTR, ICU User's Guide and Quick Reference-, 

RQSYSINFO structure. Chapter 1, System Call Reference 


BUS Bus type 

Set this value according to the bus functions you intend to use. For example, if you 
have a PC-compatible board in a Multibus II system, but only use the PC functions 
with the iRMX for Windows OS, set BUS=03H. On the other hand, if you use the 
same board to perform Multibus II message passing, you must enable the Multibus 
II bus functionality by setting BUS=02FI. This sets up low-level functionality such 
as the type of DMA transfers, etc. 


Value 

Meaning 

01 H 

Multibus 1 

02H 

Multibus II 

03H 

PCs 


DIB, DOB 

Multibus II message passing DMA alignment buffer size 
Solicited message buffers must be aligned on 4-byte boundaries (low 2 bits of 
buffer address are 0). DIB is for input and DOB for output. Adjust buffer size to 
be at least that of the largest unaligned solicited message. 

If you use a token for an iRMX buffer pool as a message buffer, it is automatically 
aligned. The Free Space Manager creates all segments on 16-byte boundaries (low 
4 bits of the address are 0). 
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An attempt to send or receive a message in an unaligned buffer larger than the 
configured alignment buffer size results in an E_NUC_BAD_BUF exception. 

Default Exception Handler 

Specifies one of two default system exception handlers, which also act as hardware 
trap handlers: 

Value Meaning 

OOH System Debugger and System Debug Monitor (SDB/SDM) 

OFFH Nucleus job deletion handler; only recommended for fully 

debugged system because it disables the Soft-Scope debugger 

XLHM 

In the iRMX for PCs OS only, these parameters work together to exclude a range of 
memory from being reclaimed by the OS. . The normal operation of this OS is to 
reclaim lower memory during initialization for use as OS system memory. The 
beginning of this memory to be reclaimed can vary; it is determined by the address 
of communications buffers set up during the boot process, but typically will be 
about 164K. The end of the memory to be reclaimed is 640K. On certain boards 
with specific I/O restrictions in this area, you may need to exclude a range of 
memory from being reclaimed. For example, on an SBC PCP4 board, you may 
need to set up dual-port memory with Multibus in this range. 

To exclude memory in this range from being reclaimed, set XLLM to the low 
physical address and XLHM to the high address for the range you want to exclude. 
If you set the exclusion range within 16K of the boundary that would normally be 
reclaimed, the memory is excluded all the way to that boundary. For example, if 
you set XLHM to 625K, memory up to the 640K boundary is not reclaimed. 

Clock Adjust Factor 

This parameter lets you compensate for inconsistencies in particular time-of-day 
clocks. Use this only on a particular machine whose clock consistently gains or 
loses time. This factor adjusts the Nucleus time (clock ticks) relative to the time- 
of-day clock. It is a signed number, so you can set it to a positive or negative 
amount (range Oh to OFFFFH). Determine the correct value for your machine 
empirically. For example, if your machine loses 10 seconds in a day, set CAP to a 
small positive number, then set the OS time. Exactly 24 hours later, check the OS 
time and adjust CAF accordingly. 

Number of Ranges 

This parameter lets you specify up to 5 ranges of memory to be included as Free 
Space Memory, and managed by the Free Space Manager. Define the memory 
ranges with parameters LMl, HMl through LM5, HM5. 
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LMl, HMl through LM5, HM5 

Each pair of LMx, HMx parameters specifies a memory range to be included as 
Free Space, managed by the OS. Set LMx to the beginning address of the range 
and HMx to the end (top) address of the memory range. Use as many pairs of these 
parameters as you specify in the NAR parameter, up to 5. If NAR = 2, you would 
set an LMl, HMl pair and an LM2, HM2 pair. 

When you use these parameters, you must set UML (if used) lower than the first 
block beginning with LMl. Free Space memory is then defined by the following 
blocks, none of which should overlap; 

• The MEMF parameters configured into the job with the ICU, and optionally 
revised at the top end by the UML parameter in rmx.ini, define the first block. 

• The LMl, HMl parameters define the next higher block; then LM2, HM2, etc. 

• The LM5, HM5 parameters, if used, define the highest block. 

Defining Free Space memory in this way allows you to block out ranges in physical 
memory that are not part of Free Space memory and therefore not managed by the 
OS. You might need such ranges for use by device drivers, for example, to 
perform I/O in an area of physical memory. 

Dispatcher Job Block [DISPJ] 

VIE Virtualize Interrupts Enabled 

Specifies the amount of CPU control that the iRMX OS gives to DOS and 
Windows. 

Value Meaning 

OOH Interrupt virtualization disabled. The iRMX OS traps all DOS and Windows 

(false) access of the system timer and interrupt controller. DOS can use all other 

real-mode instructions supported by the CPU, including interrupts. This 
degrades interrupt latency and real-time performance, but DOS disk and 
ROM BIOS I/O perform near their native levels. The bounds of interrupt 
latency depend on the ROM BIOS and vary on different platforms. This 
setting is best for applications that use the ROM BIOS for performance- 
critical disk I/O without needing tight interrupt latency. 

OFFH Virtualizes interrupts seen by DOS and Windows, while disabling CPU 
(true) interrupts for a very short time. Virtualized interrupts have the optimum 
interrupt response time and latency, but DOS disk and ROM BIOS I/O 
performance is degraded (transfers of less than 4 Kbytes are slowed 
dramatically). With this setting, the IRMX OS traps all DOS and Windows 
access of privileged instructions (e.g., CLI, STI, INT, POPF) and accesses 
to the system timer and interrupt controller. This setting is best for 
applications that do not rely on disk I/O performance (e.g.. Nucleus level 
applications) or that use a native IRMX disk driver (e.g., Adaptec SCSI). 
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EPR ESDI drive Present 

Value Meaning 

OH No ESDI drive (if there is an ESDI drive, DOS interrupts will be missed due 
to a race condition in the ESDI ROM BIOS) 

OFFH DOS disk drive is ESDI; only recognized if VIE=0FFH (this setting can 

degrade interrupt latency in iRMX for PCs, defeating the purpose of setting 
VIE=0FFH) 

If you are using an LP486/33E Professional Workstation with an IDE drive and 
VIE=0EEH, you must also set EPR=0EEH. 

CMS Character Mode Switch 

Value Meaning 

OH Do not switch console display to text mode upon entry to SDM. 

OFFH Switch console display to text mode upon entry to SDM, allowing full 
control of the system; should be on if using Windows and iRMX OS 

iS> Note 

Specify 0 if you use Soft-Scope for Windows 
PMS Page Mode Switch 

To ensure that the video page mode works correctly when you adjust CMS, always 
set PMS to the same value as CMS. 

Basic I/O System Block [BIOS] 

GC Global Clock type 

Specifies the hardware time-of-day clock maintained by battery (global clock). 

Value Meaning 

OOH No clock (OS clock starts at the time of the last access to :system: 

directory, unsynchronized with the global clock) 

01 H SBC 546 or 549 board in a Multibus I system 
02H CSM/001 or CSM/002 clock in a Multibus II system 

03H PC system clock 

ADP Attach Device task Priority 

Specifies the priority of the BIOS attach_device task. The default priority of 81H 
is the highest priority allowed for a non-interrupt task. 

See also: Writing loadable file drivers, Driver Programming Concepts 
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CON Connection deletion task priority 

Specifies the priority of the BIOS task that deletes file and device connections. 

This can affect the performance of job deletion. Before the Nucleus can delete a 
job, all objects contained in the job must be deleted. Because connections are 
composite objects, the Nucleus cannot delete them directly. Rather, it sends them 
to a deletion mailbox where the deletion task waits. The default value of 82H is 
one greater than the default priority of the device service tasks, and should be 
sufficient for most applications. 

TTP Timer Task Priority 

Specifies the priority of the task that maintains the local (OS) time-of-day clock. If 
you adjust this value, change it in increments of 1. 

NTP Named file driver Task Priority 

RTP Remote file driver Task Priority 
ETP EDOS file driver Task Priority 

DTP DOS file driver Task Priority 

Specifies the priority of the task associated with a device when you attach it for use 
with the named, remote, EDOS, or native DOS file driver. 

In iRMX for Windows, the EDOS file driver uses the ROM BIOS, which spends 
time polling the device. You may want to set the priority of the EDOS file driver 
lower (numerically higher). Although this can degrade the performance of tasks 
using the EDOS file driver, it could speed up applications that do not depend on 
DOS file I/O. 

ENE Enable Named Eile Driver Extensions 

This parameter enables Named file driver features for compatibility with DOS; 

Value Meaning 

OH Disable extensions 

OFFH Enable named file driver extensions, including these features: 

Feature Description 

Timestamps When a file is renamed or the file permissions 

changed, the last access time is updated, but the 
last modified time is not (no actual data in the file 
has changed). 

Rename in-place When a file is renamed within a subdirectory, the 
filename is simply changed (not moved within the 
directory). 

EFLC Force EDOS and DOS Files to Lower-Case 

Value Meaning 

OH Filenames on EDOS-managed devices are always shown in all upper- 
case. 

OFFH The a_get_dlrectory_entry system call and iRMX dir command display 
filenames in lower-case. 
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Extended I/O System Block [BIOS] 

SBS Stream file driver Buffer Size 
PBS Physical file driver Buffer Size 
NBS Named file driver Buffer Size 
RBS Remote file driver Buffer Size 
BBS EDOS file driver Buffer Size 
DBS Native DOS file driver Buffer Size 

The size (O-OFFFFH bytes) of EIOS buffers for file drivers. When a task opens a 
connection to a file, the EIOS creates buffers equal to the largest multiple of device 
granularity that does not exceed the value specified here. Farger buffers increase 
I/O performance, at the expense of system memory. The memory tradeoff must be 
considered, since buffers are allocated on a per-connection basis system-wide. 
Increasing the default size can provide an increase in the sequential I/O 
performance, but will not enhance random I/O performance. OS utilities use two 
buffers for each open connection. Your application can specify the number of 
buffers used each time a task opens a connection. 

See also: s_open. System Call Reference', 

EIOS buffering. System Concepts 

DDS Default Directory Size 

Specifies the maximum number of entries (05H-0F00H) in the object directories for 
all I/O jobs created by the EIOS. 

You normally use the default value. However, I/O jobs can communicate only 
through the object directory of a common ancestor job, so your system might 
require a higher value. iRMX for Windows and iRMX for PCs require at least 25 
entries because they include the HI layer. 

ADV Automatic boot Device name 

Specifies the physical name (network name if remote) for the boot device. 
Typically, this entry will not appear in rmx.ini except in remote boot applications. 

AFD Automatic boot device File Driver 

Specifies the file driver used by the boot device in the ADV parameter: 

Value Meaning 

0 Not a valid file driver ID 

1 Physical 

2 Stream 

3 Native DOS 

4 Named 

5 Remote 

6 EDOS 

7-1 6 Available for loadable file drivers, including NFS 

See also: Writing loadable file drivers. Driver Programming Concepts 
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Human Interface Block [HI] 

SCF System Configuration File 

Specifies the filename for the system initialization file; the default is r?init, but you 
can use this parameter to specify another file. For example, if you set SCF to 
initrsd, the initialization executes commands from :config:initrsd instead of r?init, 
and then attempts to execute commands from :config:initrsd2 instead of from 
r?init2. 

See also: FII initialization and logon, Chapter 1 

TCF Terminal Configuration File 

Specifies the filename for the terminal initialization file; the default is 
:config: terminals, but you can use this parameter to specify another file. 

See also: Terminal Configuration File, Chapter 2 

JST Job Synchronization Timeout 

When the -w switch is used with sysload, it waits until this timeout value expires 
or until the job catalogs R?END_INIT , whichever comes first. Cataloging 
R?END_INIT(it can have a null token) indicates the end of initialization. The 
default value of JST (1770) corresponds to 1 minute. 

Shared C Library Block [CLIB] 

NEB Number of BIOS Buffers 

Specifies the number of BIOS buffers to be associated with file connections created 
by C library calls. Bach task can also configure its own number of BIOS buffers 
with the _set_info function. 

See also: CINBO_STRUCT, C Library Reference 

MBS Malloc Block Size 

The size in bytes of the iRMX memory segment used to satisfy calls to malloc. A 
segment of this size is created for each job using the C library when the first call to 
malloc is made from that job. When all the memory in a given segment has been 
allocated by malloc calls, another segment of MBS size is created (up to the job's 
memory limit). 

Keyboard Block [KEYBD] 

TE Console Toggle Enable 

Value Meaning 

OH Disables toggling console ownership between iRMX and DOS through 
<Alt-SysRq> 

OFFH Enables <Alt-SysRq> toggle 
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DOC DOS Owns Console 

Value Meaning 

OH iRMX OS owns console 

OFFH DOS owns console on boot (default) 

RDA Reset Disable 

Value Meaning 

OH Enable <Ctrl-Alt-Del> 

OFFH Disable <Ctrl-Alt-Del> (system reset) 

MBD Monitor Break Disable 

Value Meaning 

OH Enable <Ctrl-Alt-Break> as means to actuate the monitor 

OFFH Disable <Ctrl-Alt-Break> keys so you can not break to the monitor 

Peripheral Controller Interface Adaptec Driver Block [PCIAD1] 

LUNOONLY 

Logical Unit 0 Scan 

This specifies the PCI server to scan for logical units other than 0 at initialization. 
Some SCSI devices do not operate correctly when an attempt is made to access 
logical units greater than 0. 

Value Meaning 

0 Scan for all logical units 

OFFH Scan for logical unit 0 only 

SBT System Bus Type 

Same as the BUS parameter in the [NUC] block. 

Value Meaning 

01 H Multibus I 

02H Multibus II 

03H PCs 

BT Board Type 

Set to one of the following; 

Value Meaning 

07H SBC 486SX25, 486DX33, 486DX66 

08H SBC P5090 and P51 20, all versions 
30H SBC PCP4DX or SX versions 

40H PC systems 
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SCSICONTYPE SCSI Controller Type 
Set to one of the following: 

Value Meaning 

22H Adaptec 1 542/1 742 

23H Adaptec 6360 chip (on SBC 486DXxx boards) 

24H Adaptec 7850 chip (on SBC P5090, P5120 and PCP4 boards) 

HABASE Host Adapter Base port address 

Use this parameter to specify the base port address of an Adaptec 1542 or 1742 
SCSI host adapter as configured by jumpers on board. 

BASEADDR Host Adapter Base port address 

Use this parameter to specify the base port address of a board that uses an Adaptec 
6360 or 7850 SCSI chip. This includes the SBC 486DXxx, P5090, P5120 and 
PCP4 boards. 

DMA DMA Channel 

DMA channel as configured by jumpers on board. 

See also: Adaptec hardware manual for address and DMA jumper information 

CCBS Command Control Blocks 

Number of CCBs for this board, from 8 to 64. The more you request, the more 
memory is used. There is no benefit to having more than 8 CCBs if there are not 
more than 8 devices on the same SCSI bus. 

STO Select Time Out 

The amount of time ( 1 -OFFFFH ms) to wait for a device to respond before 
returning an error. 

BONT Bus On Time 

Specifies the time in microseconds that the host adapter spends on the bus when 
transferring data. For the Adaptec 6360 chip the valid range of values is OH-OFH; 
for 1542/1742 boards the valid range is 02H-0FH. 

BOEET Bus Off Time 

Specifies the time in microseconds that the host adapter spends off the bus during a 
data transfer. For the Adaptec 6360 chip the valid range of values is OH-OFH; for 
1542/1742 boards the valid range is 04H-040H. 
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BXS 


SCSI Bus Transfer Speed 

These values set a transfer rate in megabytes/sec. (For the Adaptec 1542/1742 this 
actually sets the DMA transfer rate instead of the SCSI bus transfer rate; see the 
Adaptec hardware manual for values 80H-0FFH.) 


Value 

1542/1742 

Value 6360 Chip 

Value 

7850 Chip 

OH 

5.0 MB/sec 

OH or 19H 10 MB/sec 

OH 

1 0 MB/sec 

1H 

6.7 MB/sec 

25H 6.67 MB/sec 

08H 

8 MB/sec 

2H 

8.0 MB/sec 

32H 5.0 MB/sec 

10H 

6.7 MB/sec 

3H 

10 MB/sec 

3EH 4.0 MB/sec 

18H 

5.7 MB/sec 

4H 

5.7 MB/sec 

4BH 3.33 MB/sec 

20H 

5.0 MB/sec 

80-FF 

see manual 

57H 2.86 MB/sec 

28H 

4.4 MB/sec 



64H 2.5 MB/sec 

30H 

4.0 MB/sec 



70H 2.22 MB/sec 

38H 

3.6 MB/sec 


INTL Host Adapter Interrupt Level 

The iRMX encoded interrupt level; on an adapter where you set a DOS interrupt 
level you must correlate between the iRMX and DOS interrupt values. On the 
SBC P5090 boards this parameter is ignored and the value read from CMOS 
memory. 

See also: Table 4-3, DOS Interrupt Requests and iRMX Encoded Interrupts, 

Chapter 4 

SIN Server Instance 

The instance of the PCI Server running for this board; 0 specifies the first instance 
and 1 specifies the second. 

RESSCSI Reset SCSI Bus 

Value Meaning 

OH Don’t reset the SCSI bus at initialization 

OFFH Reset the bus at initialization 

SCSIID SCSI ID 

You can set the SCSI ID for the device on boards that use the Adaptec 7850 chip. 

Network User Administration Biock [UA] 

CNN Client Node Name 

Specifies the client (consumer) name of the system in a string of 3 to 8 characters. 
CNP Client Node Password 

Dynamic logon password for the client system in the CNN parameter. 

iS> Note 

The password you specify here is the real password (not 
encrypted). 
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MIP Block [MIP] 

DN Device Name 

Specifies the device where the iNA 960 load file resides. Only valid if LD is set to 
'LOCAL'. 

LD iNA Load 

Specifies how the NIC is loaded with iNA 960 transport software. Use one of these 
values: 

Value Meaning 

'LOCAL' Download a file from a local hard disk. 

'NOLOAD' Do not load INA software from this CPU board. 

FN iNA File Name 

Pathname of the iNA 960 load file. This parameter is only valid if LD is set to 
'LOCAL'. 

See also: i*.job. Chapter 4 

CBN Communication Board Name 

Specifies the NIC for a Multibus II system. The name must match the one encoded 
in interconnect space on the board. 

CBI Communication Board Instance 

Specifies the instance of the NIC in Multibus II systems. This is not the slot in 
which the board resides. If there is more than one board of this type, this specifies 
which board to load the iNA 960 software onto. 1 specifies the first such board 
found in the system, counting up from slot 0, up to 14H. 

See also: MIP jobs. Network User's Guide and Reference 

[MIPxx] Blocks for Multibus II 

The icemb2.job MIP job ignores the [MIP] block in the rmx.ini file. Instead, it uses 
one or more [MIPjcx] blocks, where xx is a decimal number ranging from 00 to 19. 
Each block must be in sequence in the file, beginning with [MIPOO]. The purpose 
of these blocks is to provide access from a single CPU board to multiple NICs. The 
number xx specifies the instance of the NIC, counting up from slot 0. For example, 
the block [MIPOO] refers to the first network controller, found in the lowest slot 
number of the system. Block [MIPOl] refers to the second instance, etc. 

In one block you could configure downloading of an iNA 960 load file to a separate 
NIC. In another block you could set LD= ' NOLOAD ' to use a CPU board running an 
iNA 960 COMMputer job as the NIC. 

Each [MIPjcjc] block can have the same parameters as the [MIP] block listed above, 
with the exception of CBI. 


System Configuration and Administration 


Chapter 5 


139 



iRMX-NET Server and Client Blocks [RNETS] and [RNETC] 

CBN Communication Board Name 

If you use a COMMengine environment (running a MIP job on the local board), 
this parameter specifies the board name of the NIC from which the iRMX-NET 
Server and Client jobs take their services. The name must match the one encoded 
in interconnect space on the board. 

CBI Communication Board Instance 

If you use a COMMengine environment (running a MIP job on the local board), 
this parameter specifies the instance of the board type named in the CBN 
parameter. This is not the slot in which the board resides. If there is more than one 
board with this name, specifying 1 for CBI indicates the first such board found in 
the system, counting up from slot 0; 2 indicates the second such board, etc. 


□ □ □ 
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Configuring System Jobs 

Using the ICU \J 


This chapter describes system jobs that you can configure into the OS using the 
ICU. These first-level jobs run at the same level in the job tree as OS jobs. Use 
the ICU screens listed below to configure these system jobs: 


Job ICU Screen(s) 

ATCS SYSJ, ATCJ, 

ATC50 

Bootserver SYSJ, BSJ 

C Library SUB, CLIB 
Downloader SYSJ, DLJ 


FPI server SYSJ, FPU 


iNA 960 NET, ICMPJ, 
MIPJ, NS, 
NSDOM 


Description 

The Asynchronous Terminal Controller Server 
(ATCS) manages Multibus II terminal controller 
boards. To use the ATCS you must start this job for 
each terminal controller board, then an ATCS device 
driver on all hosts that use the board through the job. 

The Multibus II Systems Architecture (MSA) 
Bootserver job receives and services requests from 
boot clients that want to boot dependently. It is an 
implementation of the MSA bootserver protocol. 

Version of the loadable clib.job that runs as a layer 
of the OS when configured by the ICU. 

The Multibus II downloader job loads object files 
for the OS and application programs onto boards in 
a Multibus II system. This job is available both as 
an ICU-configurable job on the DLJ screen and as 
the dload command. 

The Front Panel Interrupt (FPI) server job sends an 
interrupt to the Multibus II host board on which the 
CSM/002 clock module and front panel switch is 
mounted. Other hosts on the system bus do not 
know an interrupt has occurred. 

The iNA 960 network jobs provide programmatic 
access to OSI network protocols. You must load an 
iNA 960 job to run iRMX-NET or TCP/IP. 

See also: i*.job, Chapter 4 
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Job 

ICU Screen(s) 

Description 

iRMX-NET 

NET, RCJ, EC, 
REM, RSJ, ES 

The iRMX-NET client and server jobs provide 
transparent file access on top of an iNA 960 job. 

Paging 

subsystem 

SUB, PIMM, 
APPL 

The paging subsystem manages memory with the 
processor in paging mode, to support flat model 
applications. 

PCI server 

SYSJ, PCIJ, 
PCISC 

The Peripheral Controller Interface (PCI) server 
manages SCSI-based peripheral devices. On each 
host that uses a SCSI device, configure a PCI driver 
to communicate with the PCI server, using the DPCI 
screen. 

Soft-Scope 

debugger 

SYSJ, SSKJ 

Version of the loadable sskernel job that runs as a 
layer of the OS when configured by the ICU. 

TCP/IP 

SUB, NET, 
TCPJ, lESP, 
ROUTE, 
TCPl-3, STRM 

ICU-configurable version of the loadable 
itcpkern.job that runs as the TCP/IP network kernel. 
TCP/IP provides user commands and programmatic 
(socket) access, and supports transparent file access 
through NES. The NES client and server are 
available only as loadable jobs, not as first-level 
jobs. 

X.25 

NET, X25SJ, 
X25CJ 

The X.25 server runs on a MIX baseboard to link a 
MIX232 or MIX422 module to an X.25 network. 


The X.25 client job runs on any iRMX-based 
board(s) in the system to support your X.25 
application. 


On a Multibus II board running the iRMX III OS, you can override some ICU 
configuration parameters with entries in a Bootstrap Parameter String (BPS) file. 
This enables you to make minor changes and reboot the system, rather than 
generating a new boot image. 

See also: ICU User's Guide and Quick Reference for ICU screen details; 

BPS parameters, MSA for the iRMX Operating System 


142 


Chapter 6 


Configuring System Jobs Using the ICU 



ATCS Job 


ATCS Job 

ATCS jobs are specific to the type of terminal controller being managed. There are 
three ways to start an ATCS job, depending on the terminal controller; 

• Configure an ATCS job in the ICU 

• Load an ATCS job with a sysload command 

• Download the job with the Multibus II downloader (either the ICU-configured 
version or the dload command) 


See also; dload. Appendix B 

Choose the ATCS job and configuration method 

from this list: 

Controller Board 

Server Name 

Method 

1 86/41 0 

afcs.4/0 file 

Downloader 

1 86/450 

atcs.450 file 

Downloader 

MPI 450 

atcs.450 file or 

Downloader 


ATCS/450 Server 

ICU-configured job 

MIX 450 

ATCS/450 Server 

ICU-configured job 

SBX 279 graphics 

ATCS/279/ARC Server 

ICU-configured or 
loadable job 


ATCS/279/ARC Job 

The ATCS/279/ARC job typically manages the system console. It operates in one 

of two ways: 

• If there is an SBX 279 graphics board on the host where the server is 
configured, the server manages this graphics terminal, with multiple windows 
available for other CPUs on the bus. 

• If there is not an SBX 279 board, the server multiplexes a character-based 
terminal on this host between CPUs on the bus; you switch CPUs with a hot 
key. 

See also: atcs279.job. Chapter 4 

iS> Note 

If the ATCS/ARC Server is configured for the t82530_0 device 
(no SBX 279), tasks at priority 255 do not execute. The 
workaround is to make sure that all application tasks execute at 
priority 254 or higher (numerically lower). 
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ATCS/450 Job 

The MPI 450 board is a non-intelligent controller board. It has identical hardware 
to the 186/450 board. 

For MIX 450 modules, the ATCS/450 server job must be configured on the MIX 
baseboard containing the 450 modules. If there are not three 450 modules on the 
baseboard, the ATCS job can also manage MPI 450 boards (to a maximum of 36 
serial ports) located in higher slot numbers on the bus. 

See also: ATCS/279/ ARC/450 system jobs. Appendix C 

Configuring ATCS Drivers 

The configuration of the ATCS driver is identical in most of the standard 
Multibus II ICU definition files. When a definition file includes both the ATCS 
driver and the SBX 279A driver, as is the case for the SBC 386/258 and 486/133SE 
boards, use the 279A driver DUIBs. The ATCS driver does not provide them. 

See also: ATCS/279/ ARC job. Appendix C for 279 DUIB names. 

Table 6-1 summarizes the ATCS configuration parameters for the first instance of 
each board; you may configure more instances. You can specify the configuration 
in the ICU or use System Parameter Strings (SPS) in the MSA Bootstrap Parameter 
String (BPS) file. SPS parameters supersede values set with the ICU. 

See also: SPS parameters, MSA for the iRMX Operating System 


Table 6-1. Standard ATCS Device Driver Configurations 


Board ID 

DUIB Names 

Line/ 

Unit 

DEV 

Parameter 

SPS 

Parameter 

1 86/41 0 

T_ATCS_A0 ... T_ATCS_A1 1 

0 ... 

11 

ATCS_A 

RO_ATCS_A 

1 86/450 

T_ATCS_B0 ... T_ATCS_B1 1 

0 ... 

11 

ATCS_B 

RO_ATCS_B 

MIX baseboard, 
450 modules 

T_ATCS_C0 ... T_ATCS_C35 

0 ... 

35 

ATCS_C 

RO_ATCS_C 

486/125* 

T_ATCS_D0 ... T_ATCS_D35 

0 ... 

35 

ATCS_D 

RO_ATCS_D 

386/258 ** 

ATCS CON 0 ... 

ATCS CON 4 

0 ... 

4 

ATCS_CON 

RO_ATCS_CON 


T279 0 ... T279 4 

0 ... 

4 

ATCS_CON 

RO_ATCS_CON 


* and all other CPU boards 
** and all other I/O Server boards 


144 


Chapter 6 


Configuring System Jobs Using the ICU 




ATCS Job 


iS> Note 

If the ATCS driver is configured to strip the parity bit on input 
characters, special characters (07FH and above) are not processed 
properly if they also happen to be signal characters. 

Example Configurations 

These examples illustrate ways you can change the configuration to use multiple 
boards of one type. You can use the BPS file or ICU. In the BPS file, the board ID 
is the bnam option and the board instance is the bin option. In the ICU these are 
the BID and IN options. 

SBC 186/410 

Six serial channels, first one is t_atcs_aO. If adding a second board, change the 
board ID of the second set (currently assigned to the 186/450) to 186/410 and the 
board instance to 2. In the BPS file, modify the SPS parameter rq_atcs_b. You 
would then use the first six of both the t_atcs_a? and t_atcs_b? physical 
device names. 

Use the ICU to create DINFO and UINFO tables, and DUIBs for each additional 
board, assigning unique physical device names. 

SBC 186/450 

Twelve serial channels, first one is t_atcs_bO. If adding a second board, change 
the board ID of the first set (currently assigned to the 186/410) to 186/450 and the 
board instance to 2. In the BPS file, modify the SPS parameter rq_atcs_a. You 
would then use both the t_atcs_a? and t_atcs_b? physical device names. 

Use the ICU to create DINFO tables, UINFO tables, and DUIBs for each additional 
board, assigning unique physical device names. 

MIX X86/020 

Baseboard with one to three MIX 450 modules mounted on it, for up to a total of 
36 serial channels, first one is t_atcs_cO. If adding a second board, change the 
board ID of the fourth set (currently assigned to a CPU board) to the board ID for 
the MIX baseboard and change the board instance to 2. In the BPS file, modify the 
SPS parameter rq_atcs_d. You would then use both the t_atcs_c? and 
t_atcs_d? physical device names. 

Use the ICU to create DINFO tables, UINFO tables, and DUIBs for each additional 
board. Assigning the same MIX board ID, but unique instances and physical 
device names. 
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CPU board (SBC 486/125 and ATCS/450 job) 

A CPU board can control one to three MPI 450 boards for up to 36 channels, first 
one is t_atcs_dO. Each can control no more than three MPI 450 boards. If you 
use multiple CPU boards running this server, the board ID and board instance 
parameters must be unique in each iRMX boot file. In the BPS file, modify the 
SPS parameter rq_atcs_d. 

I/O board (SBC 386/258 and ATCS/279/ARC job) 

The ATCS/279/ARC server job can provide terminal I/O for not only the I/O 
Server board, but for all other CPU boards in the system. This job manages I/O 
either in graphic windows (on the SBX 279 A board using the 279 portion of the 
server) or on a serial terminal (using the ARC portion of the server). There are 5 
device names that support windows on the SBX 279A board. The first of these 
device names is t27 9_0. When using a serial terminal, the ARC server supports 
one connection per CPU board, named atcs_con_0 on each board. The DUIB 
names atcs_con_l through atcs_con_4 are not available with the ARC server. 

Use the ICU to create DINFO tables, UINFO tables, and DUIBs for each additional 
board. Assign the same I/O Server board ID, but unique instances and physical 
device names. You can modify the board ID and board instance parameters in the 
BPS file with the SPS parameter rq_atcs_con. 

See also: Multibus II standard definition files, ICU User’s Guide and Quick 

Reference, to see which default configurations include the ATCS/450 
and ATCS/279/ARC servers 
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Bootserver Job 

The Bootserver is an I/O job created during OS initialization. When a host requests 
bootstrapping, the Bootserver reads the dependent second stage from disk and 
sends it to that boot client. The dependent second stage runs on the boot client and 
issues a request to the Bootserver to load the target file containing the OS. The 
Bootserver remains an active job in the system as long as the system runs. You can 
access the Bootserver through the Nucleus message-passing system calls; bootstrap 
requests use these calls. The Bootserver uses BIOS calls to access configuration 
files, bootloader second stage files, and OS target files. 

See also; MSA for the iRMX Operating System and 

Multibus II System Architecture Bootstrap Specification 

The Bootserver does not attach devices; therefore, pathnames passed to it must 
contain a logical device name. The device referenced by the logical name must 
already be logically attached. You can attach the device with an BIOS 
logical_attach_device system call or, if the Bootserver is running on a host that 
includes the HI, you can invoke the attachdevice command at the command line. 
Do this attachment before any boot client attempts to reference that logical device. 
If you specify a null logical device name, the system uses the default logical device 
specified in the ICU. 

The Bootserver conforms to the Bocal Boot Service compliance level of the MSA 
architecture. It provides the message requests shown in Table 6-2. 


Table 6-2. Bootserver Functions 


Bootserver Function 

Request Value 

Response Value 

Locate Bootserver 

01H 

8001 H 

Locate Config Server 

02H 

8002H 

Connect Bootserver 

OSH 

8003H 

Open Second Stage 

04H 

8004H 

Get Host BPS 

OSH 

8005H 

Open File 

06H 

8006H 

Read File 

07H 

8007H 

Seek File 

OSH 

8008H 

Close File 

09H 

8009H 

Disconnect Bootserver 

OAH 

800AH 
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MSA Bootserver Job 


Required Bootstrap Parameter String (BPS) Parameters 

Unlike the loadable bootserv.job (which uses a default BPS filename or a BPS 
filename in the sysload invocation), the linkable Bootserver job requires a 
BL_conf ig_f ile parameter in the Bootserver's host BPS Save Area. The 
Bootserver uses this value as the pathname to locate the BPS file. A fatal error 
occurs and the Bootserver job is deleted if this parameter is not set when the 
Bootserver initializes. 

The BL_conf ig_f ile parameter is not normally defined in the BPS file. 

However, for a host that boots independently or quasi-independently, where this 
parameter is not already defined, the second stage bootstrap loader sets 
BL_config_f ile to a default value: /msa/config/bps. For such a host, if 
/msa/config/bps is the proper pathname, you need not take any special action. 

In systems where a board that boots dependently hosts the Bootserver, define the 
BL_conf ig_f ile parameter in the BPS file that controls the board's dependent 
boot. Although it may seem like the parameter would not be found when defined 
in a BPS file (since it is used to point to a BPS file), the parameter is not used to 
boot the dependent host. The parameter is used by the Bootserver after the host has 
booted. 

See also: BPS parameters, MSA for the iRMX Operating System 

Initialization Errors 

If you enable reporting of initialization errors on the ICU Nucleus screen (RIE 
parameter on the NUC screen), errors that occur while the Bootserver is initializing 
will be displayed on the system console. Such errors have the form: 

MSA ERROR: xxxxH WHILE INITIALIZING BOOTSERVER - JOB DELETED 

or 

iRMX ERROR: xxxxH WHILE TNTTTALIZING BOOTSERVER - JOB DELETED 

Where xxxxH is either an iRMX condition code or an MSA Firmware error code. 

For the Bootserver to function, configure the I/O User's screen (lOUS) to a default 
I/O user named SUPER, with ID 0. 
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C Library 

The shared C library is available as a loadable job {clib.job) or as an OS layer 
configurable with the ICU. The main advantage of using the ICU-configurable 
version is that you can configure a minimal C library for systems that do not use 
upper layers of the OS. 

See also; clib.job, Chapter 4, for the loadable job description 

You link each application to a small interface library, which provides access to the 
shared C library. 

See also: Interface Libraries, System Call Reference 

Configuring the C Library for OS Layers 

The full C library requires these layers of the OS; Nucleus, BIOS, BIOS, 
Application Loader, and HI. These are all the OS layers except the DDL If you 
configure out any of these layers with the ICU, you cannot use certain C functions. 
For example, the HI is required to parse command-line arguments {argc, argv). 

The minimal configuration for an application that makes C library calls is one that 
includes only the Nucleus and the C library. 

Using the ICU, you can limit these functions available in the C library; 

• Math support; The math coprocessor support library and related functions are 
included by default. 

• HI functions: If you configure the HI out of the system, several C library 
functions that use the HI are configured out automatically. This includes 
parsing of command line arguments; when the HI is not present, argc is always 
zero and argv is always null. 

See also: _get_arguments, C Library Reference 

• I/O functions: If you configure either the BIOS or BIOS out of the system, 
some I/O-related functions are automatically configured out of the C library. 

• Console I/O; On the CLIB screen of the ICU, you can specify that console I/O 
is supported by the BIOS, by the SDM Monitor, by a user routine (that you 
supply), or that there is no support (Nucleus-only configuration). Console I/O 
supports the stdin, stdout, and stderr streams. 

See also: ci and co interfaces. System Debugger Reference', 

Function descriptions, C Library Reference 
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Multibus II Downloader Job 

The Multibus II downloader job loads object files for the OS and application 
programs onto boards in a Multibus II system. This job is available both as an 
ICU-configurable job (on the DLJ screen) and as the dload command. If you 
configure this job with the ICU, it executes after the BIOS is initialized and before 
the BIOS and I/O jobs. The downloader job deletes itself when it completes. 
Figure 6-1 shows how the downloader loads files onto a Multibus II controller 
board. 

See also: dload, Appendix B 


Disk 



Multibus ii paraiiel system bus 


iRMX is a registered trademark of Intel Corporation. W-061 1 

Figure 6-1. Downloading a File with dload 


150 


Chapter 6 


Configuring System Jobs Using the ICU 




Front Panel Interrupt Job 


Front Panel Interrupt Server Job 

The Front Panel Interrupt (FPI) Server Job simulates the CSM/001 board interrupt 
behavior for systems that use the CSM/002 module. A front panel interrupt is 
generated by the keyswitch on the front of the system. In the event of a front panel 
interrupt, the CSM/002 module only sends an interrupt to the host board to which it 
is mounted. Other hosts on the Multibus II bus do not know an interrupt has 
occurred, unless you configure the FPI server to run on the host for the CSM/002. 
You may have to increase the memory for the system (on the MEMS screen of the 
ICU) to accommodate the FPI Server job. 

The FPI server runs on the host in slot 0 and waits for a front panel interrupt. The 
front panel interrupt signal must be connected to master PIC level 1 . Any host on 
the Multibus II PSB, including the host in slot 0, can request the FPI Server to send 
notification of a front panel interrupt. The request for notification can be 
subsequently canceled. You make or cancel the request with one of these 
commands: 

ic -c fpi arm 
ic -c fpi disarm 

See also: ic command. Command Reference 

In the event of a front panel interrupt, each host requesting notification is signaled 
by a non-maskable interrupt (NMI) written into interconnect space. The FPI server 
does this by setting Bit 2 of the general control register (IC register 19h). 
Interconnect records for the FPI arming and disarming functions are only written to 
the host from which the ic command is invoked. 

Limitations 

The NMI is not cleared immediately. The SDM monitor may ignore several 
commands before beginning to respond normally. 

The FPI Server does not exactly mimic the CSM/001 board. The CSM/001 has an 
interconnect register in which a single agent can set its own slot ID. When an 
interrupt occurs, a special four-byte message is sent to the specified agent. The FPI 
Server owns no registers and does not send such a message. 
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iNA 960 Network Jobs 

The iNA 960 software provides a programmatic interface to the protocol layers of 
an ISO OSI network. 

To configure an iNA 960 job in the ICU, on the NET screen choose either MIP (for 
a COMMengine MIP job) or CMP (for a COMMputer job). Then set parameters 
for a MIP job on the MIPJ screen or for a COMMputer job on the ICMPJ screen. 
With a COMMputer job you can also set Name Server parameters on the NS and 
NS DOM screen. 

See also: i*.job. Chapter 4, for a list of specific iNA 960 jobs and their 

characteristics 

MIP and COMMputer jobs, Network User’s Guide and Reference 
You must run an iNA 960 job to be able to run any of these: 

• iRMX-NET 

• TCP/IP 

• NES 
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iRMX-NET Jobs 

The iRMX-NET network jobs provide transparent file access on an ISO OSI 
network based on iNA 960 software. There are two jobs; you can configure either 
one or both; 

• iRMX-NET Server, configured on the NET, RSJ, and ES screens of the ICU 

• iRMX-NET Client, which includes the Eile Consumer and Remote Eile Driver 
(RED), configured on the NET, REM, and EC screens of the ICU 

See also: Network User’s Guide and Reference for how to use iRMX-NET 

iS> Note 

If you use a loadable version of an iNA 960 job, you must use the 
loadable versions of the iRMX-NET Client and Server jobs. With 
iNA 960 configured into the OS as a first-level job, you can use 
either the loadable or first-level versions of iRMX-NET jobs. 
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Paging Subsystem Job 

The paging subsystem manages memory with the processor in paging mode. This 
job, together with the loadable /Zat.jo/?, support flat model applications produced 
with non-Intel flat model compilers. The paging subsystem job makes available 
the rqv_ system calls used by flat model applications. Enable the paging job with 
the PGS parameter on the SUB screen of the ICU. In the VSG parameter of the 
APPL screen, specify the size of virtual segment the paging subsystem will create 
when you load a flat model application. The size is rounded up to the nearest 4 
Mbytes. 

Configure memory for identity mapping on the PIMM screen. The start and end 
addresses that you enter are the 32-bit physical memory locations that the paging 
subsystem will identity-map into the linear address space. Do not enter any 
memory areas that have reserved for OS or Free Space Manager (MEMS and 
MEMF screens). 

The memory blocks that you identity-map are locations not managed by the OS 
that your flat model application needs to access. For example, you might write a 
custom device driver that performs I/O in memory space outside the OS. With a 
flat model application you would need to identity-map that memory. However, the 
general memory used by a flat model application should not be identity mapped. 
Memory that the application allocates is automatically handled by the paging 
subsystem. 

You can use either the first-level paging job or the loadable version of paging.job. 
There is no first-level version of the loadable /Zat.yo/?. 

See also: paging.job and flat. job. Chapter 4 
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PCI Server Job 


You must run a PCI server job for each instance of a SCSI host adapter board 
installed in the system. The PCI server runs on these SBC boards: 


Multibus I 

386/I2S 

486/I2S 

PCP4DX and PCP4SX 


Multibus II 

386/258 and 386/258D 
486/133SE and 486/166SE 
486SX25, 486DX33, and 486DX66 
P5090, P5090ISE, and P5120ISE 


In a Multibus II system where the PCI server and driver are on different host 
boards, they exchange commands, status, and data across the bus through message 
passing. The PCI server enables a host driver's view of the I/O server board and its 
SCSI peripheral resources to conform to the standard client-server model defined 
by the Multibus II Transport Protocol. 

In a Multibus I system or a Multibus II system where the PCI server and driver are 
on the same host board, the server and driver exchange commands, status, and data 
using short-circuit message passing. iRMX default configurations for the 
SBC 386/I2S and 486/I2S boards include the Communication Service layer for 
message passing and use the same PCI driver and server as Multibus II systems. 

The PCI server manages up to 64 outstanding commands and permits multi- 
threaded I/O operations with up to 56 SCSI peripheral devices. 


PCI Server SCSI Pass-through Capability 

The PCI protocol gives host device drivers a generic view of random and sequential 
access to peripheral devices that adhere to the SCSI protocol. Host device drivers 
can benefit from, but are not limited by, this vendor-independent view. Many 
peripheral vendors offer unique capabilities that are accessed using vendor- 
specified commands. 

Some of the PCI server jobs for particular boards give access to this functionality 
by providing a SCSI pass-through option. The PCI server still manages the 
transaction. However, the host provides the actual command that is passed over the 
SCSI bus to the device. 

See also: How to Use the PCI Server manual 
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Soft-Scope Kernel 

You can use the ICU to configure the kernel part of the Soft-Scope debugger, rather 
than loading the sskernel job. Add the job on the SYSJ screen and configure 
parameters for it on the SSKJ screen. You must load the kernel before you can 
invoke Soft-Scope at the command line or from Windows. 

Unlike the loadable version of sskernel, which requires that you also load ssload, 
the first-level job version of sskernel automatically includes ssload. 

If you want to use System Debugger (SDB) commands from Soft-Scope, configure 
SDM and SDB on the SUB screen of the ICU. 

iS> Note 

To use Soft-Scope, you must also configure the C Library, either 
as a first-level job or a loadable job. 

See also: C Library Job, this chapter 

clib.job. Chapter 4 

See also: Chapter 8 
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TCP/IP 


The TCP/IP job provides the industry standard transport protocol necessary to 
support FTP, TELNET, TETP, and NES. TCP/IP is available as a loadable job 
(itcpkern.job) or as an OS layer configurable with the ICU. In the ICU, enable 
TCP/IP on the NET screen, then configure aspects of the job on these screens: 

TCP! 

lESP 

ROUTE 

TCPl, TCP2, TCP3, and STRM (for tuning parameters) 

See also: itcpkern.job. Chapter 4 

You must run an iNA 960 job and the shared C Library job to support TCP/IP. 

Several example ICU definition files are provided in the, /rmx386/icu/ directory that 
already have TCP/IP configured. You can invoke the ICU on one of these example 
files and use the parameter definitions as is or alter them to suit your particular 
configuration. Assuming you begin with an ICU definition file that is already 
configured for TCP/IP, you must then use the ICU to do the following: 

• Use the lESP screen to configure one or more network interfaces. 

• Use the ROUTE screen to configure one or more IP Routers (if you have IP 
routers). 

See also: Installing and Starting TCP/IP, TCP/IP and NFS for the iRMX 

Operating System', 

Definition Piles, ICU User’s Guide and Quick Reference 
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X.25 Jobs 

The iRMX OS supports X.25 applications with a server job that runs on a MIX 
baseboard and a client job that runs on any other boards in the system. The server 
is available only as an ICU-configurable job, while the client is available both as a 
loadable job or an ICU-configurable job. In the ICU add either job on the NET 
screen. Configure the server on the X25SJ screen and the client on the X25CJ 
screen. 

The X.25 server is available in a preconfigured OS image that you can download to 
the MIX baseboard. 

See also: X.25 User’s Guide and Reference for more details 


□ □ □ 
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Writing a Loadabie Job 

In any iRMX OS, you can write an application as a loadable job. If you choose, 
you can create a loadable version of your application job for debugging, then a 
non-loadable version for later incorporation with the OS using the ICU. 

Write Your Application as an HI Command 

As an HI command, your application can be invoked just like any iRMX OS 
command, and run either from the command prompt or configuration file. The 
main difference from an OS command, is that the command prompt never returns. 
It continues to run until explicit termination, system shutdown, or reboot. 

See also: Creating commands. System Concepts 

If your job requires access to the :ci: and :co: standard input and output streams, 
use the -i and -o options in the sysload command. If a loadable job cannot access 
the input and output streams: 

• It cannot accept input from the keyboard. 

• It cannot display error or exit messages. 

• If there is an unrecoverable error, it should delete itself or take some action 
other than calling the exit_iojob system call. 

• It should create a log file using the same name as the job with .log appended, 
in the directory where the job is located. 
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Establish Priorities for Tasks 


Your application may need to create interrupt handlers and tasks. If so, it must 
establish a higher priority than the job that invokes it (the sysload command). To 
do this, the initial task in the loadable job makes a set_max_priority system call, 
using a priority value of 0. This enables the job to create tasks with sufficient 
priority for its needs, such as interrupt handlers and tasks. You should give time- 
critical parts of the job priority over less critical parts. 

See also: Writing loadable drivers. Driver Programming Concepts', 

set_max_priority. System Call Reference 

Debug the Loadable Job or Driver 

Load the job (or driver) with the debug command or the Soft-Scope debugger, 
rather than sysload. This removes the code from memory at the end of the debug 
session. Be sure to detach all devices before the session terminates; otherwise, 
reboot the system. Then, modify the code to fix errors discovered during the debug 
session, and reload the driver to continue debugging. 

See also: debug and detachdevice. Command Reference', 

Soft-Scope Debugger User’s Guide 

You can test a loadable job or driver by invoking it as a background job rather than 
loading it with sysload. In this case, the job remains in memory only until you 
terminate it or log off. 

You must use an alternate console when testing a loadable device driver. The 
device driver has an initialization front-end that suspends itself, leaving necessary 
code (such as the driver code) in memory. The command prompt never returns. 

See also: background and kill. Command Reference', 

Making a device driver loadable. Driver Programming Concepts 
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Automatically Booting iRMX for Windows and PCs 

You can load iRMX for Windows and iRMX for PCs from the DOS autoexec.bat 
file. This works with any supported version of DOS, 5.0 and later. 

See also: Installation and Startup manual 

You can load iRMX for Windows and iRMX for PCs from the config.sys file, but 
only on a DOS 5.0 file system. Loading from config.sys has the following 
advantages: 

• Loading the iRMX OS first enables himem.job to manage extended memory. 

This eliminates the need to load the DOS or Windows himem.sys driver 
(discarded after iRMX OS is loaded anyway). This also saves the small 
amount of conventional memory used by himem.sys. 

• DOS XMS services used by iRMX for Windows, such as DOS=HIGH and 
smartdrv.exe can be loaded using himem.job. Loading smartdrv.exe provides 
noticeable disk performance improvements to the system. 

Modify config.sys to begin with these lines (you may use other values for 
buffers, files, and lastdrive if you choose to do so): 

buf fers=40 
f iles=64 
lastdrive=Z 

install=C : \dosrmx\rmxtsr . exe 

instance : \dosrmx\loadrmx . exe -n C:\dosrmx\dosrmx -s c_dos -f d -w 


A CAUTION 

Only use the install commands listed above for starting the 
iRMX OS on DOS 5.0. You may not be able to reliably install 
the iRMX OS from the config.sys file using DOS 6.x. If you 
receive an “Error in config.sys line xx” message when the system 
boots, try ignoring the error and determine whether the iRMX OS 
has indeed been loaded. 

Then for iRMX for Windows only: 

dos=high 

instance : \windows\ smartdrv . exe /e: 2048 256 256 c 

After assigning memory to smartdrv.exe, be sure that there is at least 1 Mbyte of 
extended memory left for Windows. As your DOS applications require, you may 
also add other drivers to config.sys. 
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A CAUTION 

If you enable write cache with SMARTDRV, it can cause disk 
corruption if the write cache is not flushed to disk before you turn 
off the system. 

See also: Microsoft Windows User's Guide 

Loading Your Application 

You may want your application to run automatically when you boot the system, 
without a user ever seeing the iRMX screen. You can configure a bootable OS 
image containing your application using the ICU. In iRMX for Windows and 
iRMX for PCs, you can start an application in the :config:loadinfo file. 


iS> Note 

You can also write a custom loadable command interface to 
replace the iRMX Command Line Interpreter. 

You can also run your job (written as an HI command) in these startup files: 

:config:user/<username> 

Specify your application as the initial program in the user attributes 
file, rather than the CLI. Define a static user for the d_cons device. 
The application need not have a user interface if you do not use the 
console. This initial program should not exit; it would leave the 
d_cons user job in an indeterminate state. 

:config:r?init 

Place your application command after the command that submits 
:config:loadinfo. This method is equivalent to invoking a program 
(without sysload) as the last command in the loadinfo file. 

These limitations apply only to an application that runs in the context of the 
d_cons device and r?init: 

• If the d_ _cons device is set up as a dynamic terminal, HI initialization does not 
complete on d_cons until you press <Alt-SysRq> to switch to the iRMX 
prompt. If your application runs in the context of the d_cons device, define 
d_cons as a static logon terminal. This avoids having to switch to the iRMX 
screen. 
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• The amount of screen output generated for the static user on d_cons can 

prevent initialization from completing. If enough output is generated to fill the 
screen buffer, the HI does not complete initialization until you switch to the 
iRMX screen. To prevent this, in the static user's :prog:r?logon file, submit 
any commands to the null device: 

submit filename over :bb: 

See also: HI initialization and logon. Chapter 1 

Example iRMX for Windows Startup Application 

This example brings up an iRMX user prompt in a window under Windows when 
you turn on the system, starting the iRMX wterm demonstration program under 
standard-mode Windows. You might use these same techniques to start your own 
Windows application that communicates with the iRMX OS: 

1 . Create a static user logon for the iRMX window. 

2. In the :config:terminals file, make the d_cons device a static logon terminal 
by adding the user name from step 1 . 

3. In the XvrmJotviWin. ini file, insert this statement in the [windows] block, 
where dri ve : is the drive containing the \windows directory: 

run=drive : \windows\rmx\wterm. exe 

4. In the autoexec.bat file, add these commands at the end of the file, specifying 
drive : for the drive containing the V/oimix directory: 

drive : 

\dosrmx\rmx.bat drive 

win / s 


□ □ □ 
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Configuring Soft-Scope 
CLI Version for Remote Operation 


The Soft-Scope Debugger is provided with the OS in two different versions: 

• Soft-Scope for Windows, which you install from separate diskettes than the OS 
installation. This version of the debugger can operate in Local mode (on the 
same system as the target software) or Remote mode (on a different host 
connected with a serial cable or network to the target system). The Soft-Scope 
Debugger User’s Guide fully describes how to install and configure either 
version of Soft-Scope for Windows. 

• Soft-Scope CLI version, which you invoke from the iRMX command line 
interface (CLI), is installed with the iRMX OS. The second manual bound into 
the Soft-Scope Debugger User’s Guide describes the operation of the 
Soft-Scope CLI version debugger. 

You typically operate the CLI version of Soft-Scope on the same machine as the 
target software you are debugging. The Soft-Scope manual describes this type of 
operation. 

However, you can set up a target machine that runs the CLI version of Soft-Scope 
and control the Soft-Scope operations from a remote host running DOS or 
Windows. This chapter describes how to configure the host and target systems for 
remote operation. 


iS> Note 

The Soft-Scope manuals do not refer to the command-line version 
of Soft-Scope as the CLI version. We refer to it here as the CLI 
version to distinguish it from Soft-Scope for Windows 


System Configuration and Administration 


Chapter 8 


165 




Preparing the Target System 


Soft-Scope Kernel 

As with any version of Soft-Scope, you must run the Soft-Scope kernel and the C 
Library job on the target system. Use either the loadable versions or configure the 
first-level jobs with the ICU. If you will use System Debugger (SDB) commands 
within Soft-Scope, you must also configure SDB. The ssload job is not required 
with the CLI version of Soft-Scope. 

See also: sskernel, clib.job, and sdb.job. Chapter 4 

Soft-Scope Kernel and C Library, Chapter 6 

IRMX-NET and the Remote Load Server 

The target system must run an iNA 960 job and the iRMX-NET server (the iRMX 
client job is optional). 

See also: i*.job and rnetserv.job. Chapter 4 

iNA 960 Network Jobs and iRMX-NET Jobs, Chapter 6 

You must establish an RLS-qualified network name for the Remote Load Server. 
To catalog the name with the Name Server, include the name in the first line of the 
/net/data file during boot-up, or invoke this command. 

- setname <systein_name> rls 

- listname 

Verify that the name displayed by listname has the property type 0006. 

See also: listname, setname commands. Command Reference 

The Remote Load Server must be running on your target system. To load RLS, 
invoke the following command, or include it in the :config:loadinfo file for loading 
during boot-up. 

- sysload /rmx386/ jobs/rls . job 

See also: rls.job. Chapter 4 
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Preparing the Host System 

To invoke Soft-Scope from a remote client, use wlc.exe (Windows Load Client) or 
dlc.exe (DOS Load Client) to start the CLI version of Soft-Scope (the ss command) 
on the target machine. 

See also; dlc.exe, wlc.exe. Programming Concepts for DOS and Windows 


iS> Note 

Invoking wlc.exe causes the :home: directory and the default 
current directory {:$:) to be /user/world. To make the default 
current directory {:$:) be a directory other than /user/world, you 
must change the current directory to that directory. This can be 
done programmatically or by adding this line to the 
/util386/ssload.csd submit file: 

- attachfile /user/<username> as :$: 

The default user of the Remote Load Server is the World user. 
Therefore, World must also have access rights to this directory. 


□ □ □ 
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Keyboard and Console Information 


Keyboard Support 

In iRMX for PCs and iRMX for Windows, the Console Driver is the link between 
the OS and a special terminal called the console. The driver interfaces with two 
physical devices: an output device (video card) and an input device (keyboard). 

The video card can be an EGA, VGA, SVGA, or any completely compatible 
alternative. Operate the display adapter only in character mode with the console 
driver. Graphics mode is not supported. An application can set the EGA device to 
graphics mode, but should restore it to character mode before performing any 
character output using the console driver. 

Two keyboard types are supported: the 84-key and the 101/102-key keyboards. 

See Figure A-1 for key diagrams and refer to Table A-1 for key code translations. 
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Table A-1. Keyboard Codes 


IBM 84-Key 
Keyboard 

IBM 101 /1 02-Key 
Keyboard 

ASCII Character 
No Shift Key With Shift Key 

29H 

1BH 

ESC 


02H 

02H 

1 

! 

03H 

03H 

2 

@ 

04H 

04H 

3 

# 

OSH 

OSH 

4 

$ 

06H 

06H 

S 

% 

07H 

07H 

6 

A 

OSH 

OSH 

7 

& 

09H 

09H 

8 

* 

OAH 

OAH 

9 

( 

OBH 

OBH 

0 

) 

OCH 

OCH 

- 


ODH 

ODH 

= 

+ 

OEH 

OEH 

Back Space 


OFH 

OFH 

Tab 


10H 

10H 

q 

Q 

11H 

11H 

w 

W 

12H 

12H 

e 

E 

13H 

13H 

r 

R 

14H 

14H 

t 

T 

15H 

1SH 

y 

Y 

16H 

16H 

u 

U 

17H 

17H 

i 

1 

18H 

1SH 

0 

0 

19H 

19H 

p 

P 

1AH 

1AH 

[ 

{ 

1BH 

1BH 

] 

} 

1CH 

1CH 

Return 


1DH 

1DH 

Ctrl 


1EH 

1EH 

a 

A 

1FH 

1FH 

s 

S 

20H 

20H 

d 

D 

21 H 

21 H 

f 

F 

22H 

22H 



G 
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Table A-1. Keyboard Codes (continued) 


IBM 84-Key 
Keyboard 

IBM 101 /1 02-Key 
Keyboard 

ASCII Character 
No Shift Key With Shift Key 

23H 

23H 

h 

H 

24H 

24H 

j 

J 

25H 

25H 

k 

K 

26H 

26H 

1 

L 

27H 

27H 

5 


28H 

28H 

' 

" 


29H 



2AH 

2AH 

Left Shift 


2BH 

2BH 

\ 

1 

2CH 

2CH 

z 

Z 

2DH 

2DH 

X 

X 

2EH 

2EH 

c 

c 

30H 

30H 

V 

V 

31H 

31H 

b 

B 

32H 

32H 

n 

N 

33H 

33H 

m 

M 

33H 

33H 

, 

< 

34H 

34H 


> 

35H 

35H 

/ 

9 

36H 

36H 

Right Shift 



37H 

* (num keypad) 


38H 

38H 

Left Alt 


39H 

39H 

Space 


3AH 

3AH 

Cap Lock 


3BH 

3BH 

FI 


3CH 

3CH 

F2 


3DH 

3DH 

F3 


3DH 

3DH 

F4 


3EH 

3EH 

F5 


40H 

40H 

F6 


41 H 

41 H 

F7 


42H 

42H 

F8 


43H 

43H 

F9 


44H 

44H 

F10 
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Table A-1. Keyboard Codes (continued) 


IBM 84-Key 
Keyboard 

IBM 101 /1 02-Key 
Keyboard 

ASCII Character 
No Shift Key With Shift Key 

45H 

45H 

Num Lock 

46H 

46H 

Scroll Lock 

47H 

47H 

Home 

48H 

48H 

7 (num keypad) 

49H 

49H 

8 (num keypad) 

4AH 

4AH 

9 (num keypad) 

4BH 

4BH 

4 (num keypad) 

4CH 

4CH 

5 (num keypad) 

4DH 

4DH 

6 (num keypad) 

4EH 

4EH 

+ (num keypad) 

4FH 

4FH 

1 (num keypad) 

50H 

50H 

2 (num keypad) 

51 H 

51 H 

3 (num keypad) 

52H 

52H 

Ins 

53H 

53H 

Del 


EO 10 

Right Ctrl 


EO 1C 

Enter (num keypad) 


EO 2A 37H 

Prt Scr 


EO 36H 

/ (num keypad) 


EO 38H 

Right Alt 


El 10 45H 

Pause 


EO 47H 

Home 


EO 49H 

Page Up 


EO 4FH 

End 


E0 51H 

Page Down 


EO 52H 

Insert 


EO 53H 

Delete 
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Table A-2 lists the values returned by the console driver when various 
combinations of the function keys (FI through F12), Alt, Ctrl, as well as the letters 
are pressed. The console driver returns a NULL code (00) in front of each function 
code. For example, pressing <Alt-Fl> returns the value 0068H. By checking for 
this NULL your code can determine if a function key combination has been 
returned. 


Table A-2. Function Key Codes 


Keystroke 

Value Returned 

Keystroke 

Value Returned 

F1 

00, 3BH 

Shift FI 

00, 54H 

F2 

00, 3CH 

Shift F2 

00, 55H 

F3 

00, 3DH 

Shift F3 

00, 56H 

F4 

00, 3EH 

Shift F4 

00, 57H 

F5 

00, 3FH 

Shift F5 

00, 58H 

F6 

00, 40H 

Shift F6 

00, 59H 

F7 

00, 41 H 

Shift F7 

00, 5AH 

F8 

00, 42H 

Shift F8 

00, 5BH 

F9 

00, 43H 

Shift F9 

00, 5CH 

F10 

00, 44H 

Shift F10 

00, SDH 

F11 

00, 85H 

Shift F1 1 

00, 87H 

F12 

00, 86H 

Shift FI 2 

00, 88H 

Ctrl F1 

00, 5EH 

Alt FI 

00, 68H 

Ctrl F2 

00, 5FH 

Alt F2 

00, 69H 

Ctrl F3 

00, 60H 

Alt F3 

00, 6AH 

Ctrl F4 

00, 61 H 

Alt F4 

00, 6BH 

Ctrl F5 

00, 62H 

Alt F5 

00, 6CH 

Ctrl F6 

00, 63H 

Alt F6 

00, 6DH 

Ctrl F7 

00, 64H 

Alt F7 

00, 6EH 

Ctrl F8 

00, 65H 

Alt F8 

00, 6FH 

Ctrl F9 

00, 66H 

Alt F9 

00, 70H 

Ctrl F1 0 

00, 67H 

Alt F10 

00, 71 H 

Ctrl F1 1 

00, 89H 

Alt F1 1 

00, 8BH 

Ctrl F12 

00, 8AH 

Alt FI 2 

00, 8CH 
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Table A-2. Function Key Codes (continued) 


Keystroke 

Value Returned 

Keystroke 

Value Returned 

Alt 1 

7800H 

Alts 

7D00H 

Alt 2 

7900H 

Alt 7 

7E00H 

Alts 

7A00H 

Alt 8 

7F00H 

Alt 4 

7B00H 

Alt 9 

8000H 

Alts 

7C00H 

Alto 

8100H 

Alt a 

1E00H 

Altn 

3100H 

Altb 

3000H 

Alt 0 

1800H 

Altc 

2E00H 

Altp 

1900H 

Altd 

2000H 

Altq 

1000H 

Alt e 

1200H 

Altr 

1300H 

Altf 

2100H 

Alt s 

1F00H 

Altg 

2200H 

AItt 

1400H 

Alt h 

2300H 

AItu 

1600H 

Alt! 

1700H 

Altv 

2000H 

Altj 

2400H 

Alt w 

1100H 

Altk 

2500H 

Altx 

2D00H 

Alt I 

2600H 

Alty 

1500H 

Alt m 

3200H 

Altz 

2C00H 

Alt Esc 

Not Supported 

Alt' 

Not Supported 

Alt- 

8200H 

Alt = 

8300H 

Alt Backspace 

Not Supported 

Alt Tab 

Not Supported 

Alt [ (or {) 

Not Supported 

Alt] (or}) 

Not Supported 

Alt\ 

Not Supported 

Alt ; 

Not Supported 

Alt' 

Not Supported 

Alt <CR> 

Not Supported 

Alt , 

Not Supported 

Alt . 

Not Supported 

Alt/ 

Not Supported 

Alt <Space> 

Not Supported 

Alt Insert 

Not Supported 

Alt Home 

Not Supported 

Alt Page Up 

Not Supported 

Alt Delete 

Not Supported 

Alt End 

Not Supported 

Alt Page Down 

Not Supported 

Alt <Up Arrow> 

Not Supported 

Alt <Left Arrow> 

Not Supported 

Alt <Down Arrow> 

Not Supported 

Alt <Right Arrow> 

Not Supported 

Alt / (keypad) 

Not Supported 

Alt * (keypad) 

3700H 

Alt - (keypad) 

4A00H 

Alt + (keypad) 

4E00H 

Alt <CR>(keypad) 

Not Supported 
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These extended keyboard functions are supported: 

<Ctrl-Alt-Break> 

Causes the system to break to the SDM debug monitor. 

<Alt> When input is in raw mode, pressing and releasing the Alt key puts 

the system back to normal mode. 

<Scroll Lock> 

Controls text scrolling on the screen. This key serves the same 
function as <Ctrl-S> and <Ctrl-Q>. 

<Ctrl-Alt-Del> 

Resets the system without performing a shutdown command. 
Because no shutdown command is performed when using this key 
sequence, an error message will be displayed when the system is 
rebooted. 

<Alt-Plus> (using the + key on the numeric keypad) 

Change the foreground color. 

<Alt-Minus> 

(using the - key on the numeric keypad) 

Change the background color. 

<Alt-SysRq> 

Toggle between DOS and iRMX OS. 
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Console Output Codes 

The keybd.job console driver interprets console codes (ASCII characters 0 - IF) as 
shown in Table A-3. 

Each screen character has two bytes associated with it: one is the ASCII character 
and the other is the attribute byte. Certain console codes affect the attribute byte. 
The current attribute is the attribute in effect when you write to the screen. Set the 
current attribute with code OBH and manipulate it with code 15H. 


Table A-3. Console Codes 


Hex Code 

Meaning 

01 

Erase rest of screen 

02 

Erase line 

03 

Erase rest of line 

04 rr cc 

Set cursor absolute position; rr = row (0-18H)+20H, cc = column (0-4FH)+20H 

05 

Line delete (following lines are shifted up) 

06 

Line insert (following lines are shifted down) 

07 

Bell 

08 

Backspace 

09 

Ignored (on other consoles interpreted as a tab) 

OA 

Linefeed 

OB cc 

Set current attribute for the color of all characters to be output, where cc is 
the attribute byte to be stored in video memory (see also code 15H) 

Bit Meaning 

7 bl: foreground blink 

6 br: background red 

5 bg: background green 

4 bb: background blue 

3 fi: foreground intensity 

2 fr: foreground red 

1 fg: foreground green 

0 fb: foreground blue 

Note: some video controllers interpret fi-fr-fg-fb as a 4 bit color code; 
foreground blinking is not always supported 

OC 

Erase screen 

OD 

Carriage return 
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Table A-3. Console Codes (continued) 


Hex Code 

Meaninq 

OE 

Next character is output literally; if it is in the range 00-1 FH, it is not 
interpreted as a special character. This allows output of special characters 
like card symbols. For example, code 01 ordinarily erases the rest of the 
screen, but code OE 01 outputs the smiling face symbol. 

OF 

Set raw mode: keyboard input will come in not as ASCII codes, but as scan- 
codes. Pressing a key returns its scan-code-i-20H, releasing a key returns 
scan-code-i-AOH. Scan-codes are defined in the keyboard documentation, and 
do not depend on country information. 

Note: releasing the <Alt> key always ends raw mode, so to kill an application 
that sets raw mode, press and release <Alt>, then <Ctrl-C>. 

10 

Set cooked (processed) mode: this is the normal mode where pressing a key 
causes an ASCII code to be returned. 

11 

X-ON 

12 

Ignored 

13 

X-OFF 

14ff 

Screen saver: ff=31H means ON, else off 

15 cc 

Attribute functions (codes OBH and code 15FI manipulate the same attribute, 
but in different ways) 

cc (hex) Meaning 

01 Save current attribute (there is one save area) 

02 Restore current attribute from save area 

03 Set entire screen to current attribute 

04 Invert entire screen; swap foreground and background colors 

05 Set current attribute to default (established as a parameter when you 
load keybd.job) 

06 Leave attribute as it is (opposite of code OBFI; when you write 
characters to the screen you do not write a current attribute) 

07 Set blink bit in current attribute 

08 Clear blink bit in current attribute 

30 Use alternate character set (i.e. add 80FI to characters <80H) 

31 Stop using alternate character set 

16 

Delete character at the cursor 

17 cd 

Background: change upper four bits of the current attribute field to c 
(see code OBFI) 

18 cd 

Foreground: change lower four bits of the current attribute field to d 
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Table A-3. Console Codes (continued) 


Hex Code 

Meaninq 

19 

Cursor right (wraps) 

1A 

Ignored 

IB 

Ignored 

1C 

Cursor down 

ID 

Cursor home 

IE 

Cursor up 

IF 

Cursor left (wraps) 


iS> Note 

There is no way to return the current or default attribute value 
from the driver to your application. 


□ □ □ 
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Multibus II Downloader 


The Multibus II downloader loads object files onto boards in a Multibus II system. 
You can either invoke dload as an HI command (a job that deletes itself when it 
completes) or configure the downloader job with the ICU. A configuration file 
specifies which files are downloaded to which boards. 

Downloader Configuration File 

The downloader uses the :config:dload.mb2 configuration file to determine what 
files to download and what boards to load. A default copy of this file is installed in 
the :config:default directory. Use this copy to create your own version in the 
:config: directory. The file has this format: 

numbe r_o f _e nt r i e s 

board_name, instance, [slot_ID], filename, [omf_type] , 
[reset | noreset | resetoverr ide ] , [loadngo | loadonly] , 
[program_table_index] 

Where board_name through [program_table_index] are all on one line, and 
there may be multiple such lines. Brackets ([ ]) indicate optional parameters. 
Optional parameters separated by a bar (I) indicate that you choose one value. 
Unspecified optional parameters require a comma as a place holder. The parameter 
descriptions are: 

numbe r_o f _e nt r i e s 

Number of valid entries in the file, from 1 - 255. The downloader operates only on 
valid entries, and skips lines that have invalid parameters. 

board_name 

Name of the target board for the downloader, up to 10 characters long. With 
atscdrv, the only appropriate names are 186/410 and 186/450. You can use the 
agents alias or the ic -c agents command to display the names of boards in the 
system. 

instance 

Specifies which of multiple identical boards to load. 1 specifies the first board with 
board_name in the system, counting up from slot 0; 2 specifies the second such 
board, etc. If instance is not specified or is 0, it is ignored and the slot_id is 
used instead. If instance is not 0, slot_id is ignored. 


System Configuration and Administration 


Appendix B 


181 




slot_ID 

The Multibus II host ID (slot number) of this board. 

filename 

Pathname of the file to download. This name can be up to 45 characters long. 

omf_type 

Object module format (OMF) type of the file image to download. If you do not 
specify an OMF type, the default is OMF86. The supported OMF types are: 

OMF86 Absolute output generated by LOC86 or LIB86. 

OMF286 Absolute output from BLD286 that starts in real mode. 

OMF386 Absolute output from BLD386 that starts in real mode. 

COFF386 Files of this OMF type are a.out images that load only text and data. 

The file header must have a magic number of 14CH to indicate that 
the target board uses an Intel386, Intel486, or Pentium 
microprocessors. The a.out header must have a magic number of 
lOBH to specify that text and data are aligned so they can be directly 
paged. 

Because there can be no start address in a downloaded OMF286 or OMF386 image, 
the file must be loaded with the loadonly option. After loading such an image, 
download an OMF86 stub that transfers control to the OMF286 or OMF386 image. 
This OMF86 stub must be loaded with the loadngo option and must contain a far 
jump to the start address of the OMF286 or OMF386 image. 

reset | noreset | resetoverr ide 

Specifies whether to reset the target board before downloading. The default is 
noreset. The reset option resets the target board. Use the resetoverride 
option along with a program_table_index to invoke a downloader that coexists 
with other programs in the target board firmware. 

loadngo | loadonly 

Specifies whether the downloaded image is started immediately after downloading. 
The default is loadngo. Use the loadonly parameter to download an OMF286 or 
OMF386 image. 

program_table_index 

This is an offset in a program table that specifies the location of the downloader in 
firmware on the target board. Use this with the resetoverride parameter. 

See also: Target board's hardware reference manual for more details 
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Download Image Files 

For example, use dload to download ATCS software for atcsdrv. The download 
image files for the SBC 186/410 and 186/450 terminal controller boards are in the 
/rmx386/ios directory. Set up the downloader configuration file to load the 
appropriate file(s) and invoke dload before you load the atcsdrv driver for these 
boards; 

atcs.410 A downloadable OMF86 binary image consisting of the iRMX I 
Nucleus and a server for the 186/410 board. 

atcs.450 A downloadable OMF86 binary image consisting of the iRMX I 
Nucleus and a server for the 1 86/450 board. 

The default configuration file specifies that the first two instances of a 186/410 
board be loaded with the file :rmx:ios/atcs.410, and the first two instances of a 
186/450 board be loaded with the file :rmx:ios/atcs.450. Because the instance 
parameter is used, the Multibus II slot numbers are not specified. The object 
module format is also not specified, so OMF86 (the default) is indicated. All 
boards are reset before the file is downloaded. Any existing boards are initialized 
with this configuration. 


4 

186/410, 1,, 
186/410, 2,, 
186/450, 1,, 
186/450, 2,, 


: rmx : ios/atcs . 4 10 , , reset, 
: rmx : ios/atcs . 4 1 0 , , reset, 
: rmx : ios/atcs . 4 50 , , reset, 
: rmx : ios/atcs . 4 50 , , reset. 


If two 186/410 boards are in slots 5 and 6, you could set up the configuration file as 
follows, specifying a slot number rather than a board instance: 


2 

186/410, 0, 5, : rmx : ios/atcs . 4 10 , , reset, 

186/410, 0, 6, : rmx : ios/atcs . 4 1 0 , , reset. 


Receiving Board Requirements 

The Multibus II board receiving the downloaded file must have a firmware 
communication record in interconnect space with global read/write access. The 
resident firmware loader on the board receiving the file must be executing and 
ready to accept commands, as indicated by the READY bit in the first byte of the 
firmware communication record. Currently, the 186/410 and 186/450 boards are 
shipped with a resident firmware loader. 

See also; Information on the resident firmware loader, in the hardware manual 
for the board 
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Example Code 

This example shows the ASM86 code needed to transfer control to an OMF286 or 
OMF386 image. To specify the start address, replace xxxx and yyyy with the 
starting CS and IP register values in the map file of the OMF286 or OMF386 
image. 

START_CS EQU xxxxH ; Start executing downloaded code here 
START_IP EQU yyyyH 

CODE SEGMENT 'CODE' 

ASSUME CS:CODE 
PUBLIC start 

start : 

DB OEAH 

DW START_IP, START_CS ; FAR JMP to downloaded code 

CODE ENDS 

END start 

Error Messages 

Dload writes downloading status to the :config:dload.log file. When a fatal error 
occurs, the configuration line processed in :config:dload.mb2 is aborted and the 
rest of the lines in the file continue to be processed. 

The downloader job (dload command) expects the target board to be in a known 
state for downloading, which can only be guaranteed on reset. Otherwise, the 
downloader job erroneously reports Target Not Ready. 

The downloader reports two types of errors: 

• General errors that occur before or after object module processing 

• OMF errors that occur during object module processing 

Most download errors are considered fatal. When a fatal error occurs, the 
configuration line being processed in the :config:dload.mb2 configuration file is 
aborted, but the rest of the lines in the file are processed. 

General Error Messages 

This section lists the errors that can occur before or after object module processing. 

Attempting To Load Own Slot 

The instance or the slot number is the same PSB slot ID as the host's slot ID. This 
is a fatal error. 
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Bad Command Line 

There is a syntax error on the command line or the command line does not exist. 
This is a fatal error. 

Cannot Open Load File 

The load file specified in the command line cannot be accessed. Check the 
pathname and file permissions. This is a fatal error. 

Download Error 

An error occurred while downloading the data. This is a fatal error. 

Firmware Communication Record Not Found 

The firmware communication record on the target cannot be found in interconnect 
space. This is a fatal error. 

Instance Of Board Not Found 

The instance of the specified board does not exist in the Multibus II backplane. 

This is a fatal error. 

Invalid Object Module Format 

The object module format specified on the command line is not supported by the 
downloader. This is a fatal error. 

Invalid Slot ID 

The target slot ID specified in the command line is out of range. Valid slot IDs 
range from 1 to 19. This is a fatal error. 

No Memory Available 

The system cannot allocate the buffer needed for OMF processing. This is a fatal 
error. 

Specified Board Does Not Exist In Slot 

The board name specified does not match the board in the slot. This is a fatal error. 

Target Not Ready 

The loader on the target board does not indicate that it is ready. In other words, the 
first byte in the firmware communication record is not 80H. This is a fatal error. 

Object Module Format Error Messages 

This section lists the errors that can occur during object module processing. 

Bad Checksum 

The downloader encountered an error while calculating the checksum for a record. 
This fatal error occurs during OMF86 processing. 

Bad Header 

The file specified in the command line is not the correct file format. This fatal 
error occurs during OMF86 processing. 
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Bad Magic Number In a . out Header 

The a. out header has an incorrect magic number. The downloader supports a 
magic number of lOBH in the a. out header. This value indicates that the text and 
data segments are aligned within a. out so that they can be directly paged. This 
fatal error occurs during COFF386 processing. 

Bad Magic Number In File Header 

The file header has an incorrect magic number. The downloader supports a magic 
number of 14CH in the file header. The number indicates that the target machine 
contains an Intel386- or Intel486 microprocessor. This fatal error occurs during 
COFF386 processing. 

Bad PEDATA Record 

A PEDATA record format is incorrect. This fatal error occurs during OMF86 
processing. 

See also: PEDATA record format, iAPX 86, 88 Family Utilities User's Guide 

Bad PIDATA Record 

A PIDATA record format is incorrect. This fatal error occurs during OMF86 
processing. 

See also: PIDATA record format, iAPX 86, 88 Family Utilities User's Guide 

File Contains Fixup Records 

The file specified in the command line contains load-time locatable code. The file 
is not in absolute OMF86 format and the resulting loaded image may be incorrect. 
This non-fatal error occurs during OMF86 processing. 

File Contains Unresolved Externals 

The file specified in the command line contains unresolved external variables. The 
file is not in absolute OMF86 format and the resulting loaded image may be 
incorrect. This non-fatal error occurs during OMF86 processing. 

Invalid Module Attribute 

The file specified in the command line contains a module with an invalid attribute 
in the MODEND record. This non-fatal error occurs during OMF86 processing. 

See also: MODEND record, iAPX 86, 88 Family Utilities User's Guide 

Load File Is Empty 

The file specified in the command line contains no data. This fatal error occurs 
during OMF86 processing. 

Load File Is Not Bootloadable 

The file specified in the command line is of the wrong type. This fatal error occurs 
during OMF286 and OMF386 processing. 
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More Than One Start Address In File 

The file specified in the command line contains more than one main module with a 
start address. Only the last start address is used and the previous addresses are 
overwritten. This non-fatal error occurs during OMF86 processing. 

No Valid Start Address In File 

The file specified in the command line does not contain a start address. The file 
has been loaded. This fatal error occurs during OMF86, OMF286, and OMF386 
processing. 

Non-Main Module Has Start Address 

The file specified in the command line contains a non-main module with a start 
address. This non-fatal error occurs during OMF86 processing. 

PIDATA Recursion Level Too High 

There are greater than seventeen nested levels within a PIDATA record. This fatal 
error occurs during OMF86 processing. 

See also: PIDATA record format, iAPX 86, 88 Family Utilities User's Guide 

Premature EOF Encountered 

The file specified in the command line is incomplete. This fatal error occurs 
during OMF86, OMF286, OMF386, and COFF386 processing. 

Record Too Large 

The default buffer size is too small for the file to be downloaded. This fatal error 
occurs during OMF86, OMF286, and OMF386 processing. 


□ □ □ 
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ATCS/279/ARC/450 System Jobs 


ATCS/279/ARC Server Job 


The ATCS/279/ARC job provides a Multibus II system with either a windowed 
terminal (ATCS/279), or a multiplexed output from hosts and monitors onto a 
single terminal (ARC). The DUIB entries in the :config: terminals file and the 
system hardware determine the display environment. 

You can display the MSA firmware diagnostics on either a serial console (ARC) or 
graphics console (279), depending on the configuration of the MSA firmware. If 
the SBX scan bit is not set in the MSA firmware, the serial console is used. 

See also; SBX scan bit, MSA Firmware User's Guide 

The ATCS/279/ARC Server communicates with the ATCS driver running on other 
CPU boards using the ATCS protocol and to monitor/debuggers using the Remote 
Console Interface (RCI) protocol. 

When you have multiple CPUs in a Multibus II system, there are several options 
for providing HI terminals to each of the CPU boards: 

• Provide a separate SBX 279 A window to each of the CPU boards by using the 
SBX 279A and the ATCS/279/ARC Server. 

• Provide one physical terminal to the I/O server board in slot 0 and use the 
ATCS/279/ARC Server. 

• Provide a separate physical terminal to each CPU board. This requires using 
the serial ports on a terminal controller board and separate terminals for each 
CPU board. 


iS> Note 

If the ATCS/ARC Server is configured for the t82530_0 device 
(no SBX 279), tasks at priority 255 do not execute. The 
workaround is to make sure that all application tasks execute at 
priority 254 or higher (numerically lower). 


System Configuration and Administration 


Appendix C 


189 




Separate SBX 279A Window 

The first option requires only a single graphics monitor, keyboard, mouse, and 
cables. It multiplexes the HI terminals from multiple CPU boards to a single 
display device. Using separate windows, you can access each of the CPU boards 
by moving from one window to the next using a mouse. 

See also: SBX 279A windows. Command Reference 

The 279 portion of the Server provides three types of windows: one for clients, a 
second for debug monitors that require single character input and output, and a 
third for graphics from remote clients. The windows that support clients and debug 
monitors emulate a CRT terminal. The portion of the ATCS/279 server job that 
implements debug windows is called the Remote Console Interface (RCI) Server. 

A windowed environment for debug monitors enables multiple windows on a single 
graphic monitor display. Each window shows debug information from a different 
processor. 

One Physical Terminal to I/O Server Board 

The second option requires only a single terminal. The ARC portion of the Server 
does not provide windowing, but instead buffers information from each host OS 
(ATCS) and host monitor (RCI) line connected to it. Only the output from a single 
OS (ATCS) or monitor (RCI) line is displayed on the terminal at one time. This 
information is left on the screen until it scrolls off or is specifically cleared. You 
can choose which host is connected so that its output can be displayed. Monitor 
information takes precedence over OS information and is displayed from any host 
when it is available. 

Separate Physical Terminal to CPU Board 

The fourth option is the most flexible because it provides a simultaneous full screen 
display and keyboard input for all CPU boards. However, it also requires multiple 
cables and terminals. 

Configuring the ACTS/279/ARC Server Job 

You can load the atcs279.job with one configurable parameter, the name of the 
default terminal device. 

See also: atcs279.job. Chapter 4 
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If you add the job as a first-level job in the ICU, configure it on the ATCJ screen of 
the ICU. The Maximum System Windows (MSW) and Maximum Debug Windows 
(MDW) options are not used by the ARC server. The ARC server allocates one 
line per host for OS console I/O and one line per host for monitor console I/O. 
When queried by the CCI GET SERVER INEO command, the ARC Server replies 
that it has 21 lines available. Only one line can be used by each client host. 

See also; ATCJ screen, ICU User's Guide and Quick Reference 

You may configure the number of system windows (MSW) for the ATCS/279 
Server. Each system window requires a unique DUIB in the SBX 279A driver that 
you must configure if you include the ATCS/279 server job. These DUIBs must be 
named h27 9_0, h27 9_l and so on. The ending digit of each name corresponds to 
the ATCS line number. Other host processors can access the system windows by 
using the ATCS driver. When 0, 1, etc. are used to access system windows, the 
numbers represent ATCS lines. Eor the Maximum Debug Windows (MDW) 
option, the RCI server supports one debug window per host. The typical client of 
the RCI server is the debug monitor. 
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Choosing the ATCS/279 or ARC Console 

The DUIBs you include in your system, along with the boards or ports actually 
connected, determine which mode of the ATCS/279/ ARC job is used. The mode is 
chosen according to the flowchart in Figure C- 1 . 



om04465 


Figure C-1. Choosing ATCS/279/ARC Mode 


The terminal DUIB must be configured to point to a locally controlled serial port, 
as on an 82530 component. By default it points to Unit 0 of the on-board 82530. 
The device must be available when the BIOS is being initialized. 

Select the appropriate Console Controller driver for your console on the SDM 
screen of the ICU. 
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The ATCS/279/ARC Server supports short-circuit operations when using the ARC 
portion of the Server. The 279 portion of the Server does not support short-circuit 
operation when connected to the SBX 279A board. This means that a board cannot 
host both the ATCS Driver and ATCS/279/ARC Server and use ATCS Driver 
physical device names to access SBX 279A windows controlled by the Server. 

Mapping SBX 279A Windows to Device Names 

Table C-1 outlines the mapping of SBX 279A windows to device names as 
implemented in the standard Multibus II definition files. 


Table C-1. Mapping of the SBX 279A DUIB Names 


SBX 279 
Unit 

Local 279 
DUIB Name 
on I/O Server 

Local 279 DUIB 
Alias for 
Debug Window 

Local 279 DUIB 
Alias for 
System Window 

ATCS Driver 
DUIB name on 
Remote Client CPU 

0 

t279_0* 




1 

t279_1 




2 

t279_2 


h279_0 

t279_0* 

3 

t279_3 


h279_1 

t279_1 

4 

t279_4 


h279_2 

t279_2 

5 

t279_5 


h279_3 

t279_3 

6 

t279_6 


h279_4 

t279_4 

7 

t279_7 

m279_0 



8 

t279_8 

m279_1 



9 

t279_9 

m279_2 



10 

t279_1 0 

m279_3 



11 

t279_1 1 

m279_4 



12 

g279_0 


h279_5*‘ 

g279_0 

13 

g279_1 


h279_6 

g279_1 

14 

g279_2 


h279_7 

g279_2 

15 

g279_3 





* Note the correlation between the ATCS driver configuration on the ATCS client CPUs and the SBX 
279A configuration on the ATCS/279 I/O Server. 

** Required for server initialization. 


In the definition file for the I/O Server (such as an SBC 386/258 or 486/133SE 
board) you can delete any physical device names that your application does not 
require. 
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Since the ATCS/279/ARC Job does not support short-circuit windowed (279) 
operations, the terminal names you specify in the :config: terminals file must match 
your Multibus II system configuration. In the :config: terminals file for a board 
which hosts the ATCS/279/ARC server, an SBX 279A driver, and the ATCS driver 
(I/O Server definition files do this) and where you want to use a 279 window, 
specify the device name t27 9_0 for the SBX 279 A driver. The 
:config:default/terminals.279 file is an example of this use. In the 
:config: terminals file for a board which only hosts the ATCS driver or uses the 
ARC portion of the server, specify the device name atcs_con_0. The 
:config:default/terminals.arc file is an example of this use. 

In Table C-1, the column labeled Local 279 DUIB Name on I/O Server lists the 
physical device name used by the 279 driver to refer to its windows when the 
SBX 279A module is mounted on the I/O Server board. Similar names may be 
used if the SBX 279A module is mounted on a different CPU board. There are 12 
terminal emulation windows (they start with t) and four graphics windows (they 
start with g) in the I/O Server definition files. Some of these windows are shared 
with remote hosts which can access the windows using the ATCS/279 server. 

Either a remote host or the local host can use a window, but only one host at a time 
can access a given window. Only unit numbers 2 through 14 are accessible from 
the remote hosts. 

The column labeled Local 279 DUIB Alias for Debug Windows lists the DUIB 
names used locally by the RCI Server running on the I/O Server board. The RCI 
Server provides Debug Windows for the SDM monitor running on CPU boards. If 
there are more CPU boards than the configured number of Debug Windows, the 
SDM console on the remaining boards is the on-board serial port of the CPU board. 

The column labeled Local 279 Alias for System Windows lists the DUIB names 
used locally by the ATCS job running on the I/O Server board. These are the local 
names of System Windows for CPU boards in the system. The standard I/O Server 
board definition files provide eight such windows. Five are for terminal emulation 
and three are for graphics. The digit following the underscore (h279_n) refers to 
the ATCS line number. The ATCS driver on the CPU board uses the ATCS line 
number to access one of these windows. Only one CPU board at a time can use an 
ATCS window, but one board may use multiple windows at the same time. 
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The column labeled ATCS Driver DUIB Names on Remote Client CPU lists the 
physical device names used by the ATCS drivers on CPU boards to access remote 
windows. The ATCS driver communicates with the ATCS/279/ARC Server, which 
provides the appropriate 279 window based on the ATCS line number. The remote 
window appears to the ATCS driver as an ATCS serial line. There are eight ATCS 
DUIBs for remote windows in the standard Multibus II CPU definition files. Five 
of these are for terminal emulation and start with t27 9; three are for graphics and 
start with g27 9. By default, the ATCS driver is configured to search for a 386/258 
I/O Server. You can change this parameter in the BPS file to point to another 
board. 

Adding Remote Windows 

Each ATCS serial line corresponds to a separate SBX 279A terminal or graphics 
window. As shown in Table C-1, some 279A DUIBs are configured as System 
Windows called h27 9_n, where n corresponds to the ATCS line number. 

You can use 279A windows for the SDM monitor running on the client slots. 

These windows are called Debug Windows and are designated m2 7 9_n (assuming 
n+1 Debug Windows). Each client host needs a separate Debug Window. The part 
of the ATCS/279/ARC Server that provides Debug Window services is called the 
Remote Console Interface (RCI) Server. It allocates windows on a first-come-first- 
served basis. The SDM monitor on the client boards communicate with the RCI 
Server via Multibus II transport and Multibus II interconnect space. 

The standard definition file for the ICU provides eight System Windows. Five of 
these windows are terminal windows and three are graphics windows. Five Debug 
Windows are also supplied. If you add more hosts to your Multibus II system, the 
default number of remote windows may not be adequate. 

In these examples you use the ICU to modify the standard definition files to 
provide additional System and Debug windows. 
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Adding a System Window 

This example assumes that the ATCS/279/ARC Server runs on an I/O Server board 
with the SBX module mounted on that board. It also assumes that the client iRMX 
boards are CPU boards. 

1. In the definition file for the I/O Server board, add a unit (window) to the 279A 
driver configuration; 

• Add one more UINFO table. This is a UT279 screen for a normal 
window, or a UG279 screen for a graphics window. Copy one of the 
existing screens as an example for the parameter values. 

• Add one more DUIB, or 1279 screen. For example, copy the 1279 screen 
with the NAM value h2 7 9_7 . Change the NAM parameter to h2 7 9_8 
(because this is the ninth window) and set the UNB parameter to an 
unused unit number for this device. Make sure the new unit does not have 
the highest unit number among those configured. There must always be a 
dummy DUIB with the highest unit number configured as a Dynamic 
window (in the TYP option of the UT279 or UG279 screen). Typically 
this is the g27 9_3 DUIB name listed in Table C-1. Change the unit 
number of this dummy DUIB to be the highest. 

2. Increment the number of System Windows in the ATCS/279/ARC System Job 
configuration to 9. This is the MSW option on the ATCJ screen. 

3. Add a unit (ATCS line) to the ATCS driver configuration in the ICU definition 
file for the client CPU board: 


• Add a UINFO table (U410 screen) and a DUIB (1410 screen) for the 
ATCS_CON device. Copy and modify one each of the existing screens. 
Specify ATCS line 8; on the U410 screen, change the NAM parameter to 
UINFO_ATCS_CON_8 and on the 1410 screen, change the UN parameter 
to 08H and the UIN parameter to UINFO_ATCS_CON_8. The 
ATCS/279/ARC Server maps this to the h27 9_8 DUIB that you added in 
step 1. 

• If you are adding a graphics window (device name g27 9_n), set the 
following ICU options as shown. These appear on the U410 screen; 


Configuration Option 

(LEM) Line Edit Mode 
(ECH) Echo Mode 
(OCC) Output Control in Input 
(OSC) OSC Controls 


Parameter Value 

trans 

NO 

NO 

NO 


4. Regenerate the systems for both the I/O Server board and the CPU board. 
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Adding a Debug Window 

This example assumes that the ATCS/279/ARC Server runs on an I/O Server board 
and that the SBX 279A module is mounted on that board. 

1. In the definition file for the I/O Server board, add a unit (window) to the 279A 
driver configuration; 

• Add a UINFO table or UT279 screen. Copy and modify one of the 
existing screens. 

• Add a DUIB or 1279 screen. Set the NAM value to m2 7 9_5, for the sixth 
Debug window. Set the UNB parameter to an unused unit number for this 
device, making sure the new unit does not have the highest unit number 
among those configured. (See the previous example.) 

2. Increment the number of Debug Windows to 6. This is the MDW option on 
the ATCJ screen. 

3. Regenerate the system image using the ICU G(enerate) command. 

ARC Server 

The ARC Server initializes and displays its query at the system console before the 
HI initializes. If there is no operator response to the query, the console displays the 
HI logon prompt. 

The first OS or monitor that makes an input request gets control of the console. 
When connected, all user input goes to that host. The ARC server lets you specify 
and use a hot key to connect to any host. By default, the hot key is <Break> for a 
local terminal and <Ctrl-Y> if you use a modem. 

If the OS (ATCS client) is active when you switch the console to a new host, any 
buffered ATCS output from that host is displayed and input is sent to the OS. If the 
monitor (RCI client) is active, input is sent to the monitor. 

When monitor output becomes available from any client host, the monitor output 
will interrupt output from an OS. If multiple monitors are trying to do output at the 
same time, all output from the first active monitor is completed. Then output from 
the next client host's monitor is displayed until it has completed. This is repeated 
until no monitor output is available. At that time, the interrupted OS's output is 
resumed. 

When switching monitor output, the ARC server displays a header showing which 
host is displaying information. The header scrolls off the screen as more 
information is displayed. The SDM monitor prompt always identifies the host it is 
running on. 
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The ARC Server provides a menu for switching between clients using the same 
physical serial I/O device. You invoke the ARC menu with the hot key; the menu 
is also displayed for five seconds during server initialization (see Figure C-1). This 
enables you to connect to a specific host or to change the hot key before being 
required to use it. Where the SBX 279A module is present, the server sign-on 
menu is: 


MULTIBUS II CONSOLE SERVER INITIALIZATION 

•k'k'k'k-k'k'k'k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k'k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 
•k ~k -k -k 

** ENTER <CR> WITHIN 5 SECONDS for this to be the SYSTEM CONSOLE ** 

W -k -k 

•k'k'k'k-k'k'k'k'k-k-k-k-k-k-k-k'k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

-k'k’k'k'k'k'k'k'k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 
•k ~k -k -k 

** Terminal Setting: 9600 BAUD, 8 BITS, 1 STOP BIT, NO PARITY ** 

* W -k -k 

•k'k'k'k'k'k-k'k'k-k-k'k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 


If no SBX 279A module is present, the first message is slightly different: 

ENTER <CR> WITHIN 5 SECONDS to change the HOT KEY 

You cannot use the HI until a client host has made an input request. The first client 
host which makes a connection to an ATCS line and requests input becomes the 
active client. This could be either an OS or a monitor client. 

When you press the hot key, the HI displays this prompt: 

Enter <0-20> to Select Client Host OR <CR> to Display Menu 

The ARC menu enables you to select the client host, select the hot key, and/or to 
print a separator between RCI output from different client hosts. The menu is 
displayed if you press <CR> after the initialization prompt or after the host 
selection prompt. As shown in this example, the connected client host's slot ID is 
enclosed in parentheses at the top of the menu. 
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MULTIBUS II 

CONSOLE SERVER MENU 


- Console Client Hosts in Slots: #xx 

(#xx) #xx 

- Hot Key: 

BREAK 


- Output Mode: SEPARATED 

- Commands : 


H 

Help 


K 

Select New Hot Key 


M 

Set Monitor/Debugger Output 

Mode 

<0-20> - 

Select Client Host 


<CR> 

Exit 


Enter Choice 

- 



If you select the H command, a help message is displayed. For the K command, 
this menu and prompt are displayed. 


Select 

HOT KEY - 

1 

- ~ 

2 

- CTRL Y 

3 

- BREAK (default) 

<CR> 

- Exit 

Enter 

Choice - 


For the M command, this prompt is displayed. 


Separate Output from different Monitor/Debugger Client Hosts [Y/N] ? 
Enter Choice - 

If you enter 0 through 20 at the main menu, input is sent to the selected client host, 
if present. If the client host ID is not valid or the client host is not present, the 
server displays this error message. 

*** Warning: Invalid Client Host, Active Host Not Changed 

If invalid input is given to the server at any other time, the server displays this error 
message. 

*** Warning: Invalid Entry 


ATCS/450 Job 


The ATCS/450 job provides access to the serial channels on the MPI 450 and the 
MIX 450 boards. Each of these boards has 12 serial channels. A single ATCS/450 
Server can control up to 36 serial channels. 
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The ATCS/450 job shields clients from the low level hardware interfaces required 
to control the serial channels on the MIX 450 modules and MPI 450 boards. It 
provides a high level interface to the client OS's ATCS protocol. This job can 
support multiple clients and can be configured in multiple ways. Figure C-2 
illustrates example configurations. 

The MIX 450 module must be mounted on a MIX baseboard, such as the 
386/020(A) or 486/020A. Up to three MIX 450 modules can be mounted on a 
single baseboard. 

The MPI 450 is a non-intelligent I/O board residing on the parallel system bus 
(PSB). The ATCS/450 server communicates with MPI 450 boards using the PSB 
I/O space. Each MPI 450 board has 12 serial channels. The MPI 450 board can be 
controlled by an ATCS/450 server running on a MIX 386/020 board, the 186/450 
board, or any CPU board hosting the ATCS/450 server. 

It is possible for the ATCS driver and the ATCS/450 server to reside on the same 
host and communicate with each other using short-circuit messages, as shown in 
Figure C-2. The ATCS/450 server job can take a significant part of CPU 
bandwidth when configured with other system jobs. 
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Multibus II 



Multibus II 


iRMX is a registered trademark of Intel Corporation. W-1805 

Figure C-2. ATCSJob 
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ATCS/450 Configurations 

A single ATCS/450 server job can control up to a maximum of three MIX 450 
modules and MPI 450 boards simultaneously. Use this algorithm to assign ATCS 
line numbers to serial channels on these boards: 

1 . Assign line numbers 0 through 1 1 to serial channels on the first MIX 450 
board, numbers 12 through 23 to serial channels on the second MIX 450 board, 
and numbers 24 through 35 to channels on the third MIX 450 board. The 
ATCS job searches for MIX 450 modules on the same baseboard. 

2. If there are fewer than three MIX 450 modules on the same baseboard, assign 
the remaining line numbers to serial channels on any MPI 450 boards in the 
system. The ATCS job scans for MPI 450 boards in slots higher than the slot 
on which it resides until it finds a non-MPI board or finds a total of 36 serial 
channels (including any MIX 450s residing on MPI 450s). The serial channels 
on MIX 450s are assigned lower ATCS line numbers than channels on MPI 
450s. 

Using the guidelines above, the following configurations are possible. In each 
case, the ATCS driver could run on the same board as the ATCS/450 server job 
and/or on other CPU boards in the system: 

• The ATCS/450 server job runs on the MIX baseboard and controls MIX 450 
modules mounted on the baseboard. 

• The ATCS/450 server job runs on the MIX baseboard and controls MIX 450 
modules and MPI 450 boards. 

• The ATCS/450 server job runs on a CPU board and controls MPI 450 boards. 

Depending on the number of ATCS lines you use, and whether you include an 
ATCS driver or both the driver and the server, you may need to change some ICU 
options in the Nucleus Communication Service (NCOM) screen. The affected 
values are the Maximum Number of Simultaneous Messages (MSM) and 
Maximum Number of Simultaneous Transactions (MST) parameters. Additional 
demands may be put on these resources by the PCI server and driver or by your 
message-passing application. ATCS requirements are shown below. 


Parameter ATCS/450 Server Requirement 

ATCS Driver Requirement 

MSM 16 * (total number of ATCS lines + 1) 

1 5 * total number of ATCS lines 

MST 

6 * total number of ATCS lines 


□ □ □ 
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Index 


A 

a_get_directory_entry call, 133 
a_special call, 32 
A201ine, 73 
access rights, 34 

Adaptec SCSI board configuration, 136 
AEDIT function keys, 29 
alias. csd file, 17,21 
aliases, 17 

agents, 181 
default, 21 
<Alt> key, 176 
ARC server, 191,197 
ARC server job, 59 
argc, 149 
argv, 149 

Asynchronous Terminal Controller Server, 57 
ATCS, 57, 59, 60, 141, 144, 145, 189, 194, 
195, 198, 199, 201,202 
27 9/ ARC server, 189 
ARC menu, 198 
ARC server, 197 
ATCS/450 server, 199,201,202 
ATCS console, 192 
atcs.410 file, 183 
atcs.450 file, 183 
atcs279.job, 190 
attachdevice command, 38 
attach-device task priority, 132 
attaching devices, 44 
autoexec.bat file, starting IRMX in, 163 

B 

background command, lowering 
user priority, 23 
background jobs, 160 


<Backspace> key, 29 
bcl command, 14 
bell code, 29 
BIOS (IRMX) 
andTSC, 30 
configuration of, 132 
boot key sequence, 176 
BPS parameters 

for ATCS, 144, 145 
for MSA Bootserver, 63, 148 
buffers 

size for EDOS file driver, 134 
size for EIOS, 134 
size for named file driver, 134 
size for native DOS file driver, 134 
size for physical file driver, 134 
size for remote file driver, 134 
size for stream file driver, 134 
bus type, 129 

c 

C library, 64, 149 

load-time configuration, 135 
CDF (Client Definition File), 47, 138 
cdffile, 15 
:ci:, 36 

device, 159 

CLI (Command Line Interpreter) 
and TSC support, 30 
as initial program, 22 
function keys, 29 
lowering user priority, 23 
submit command, 17 
client definition file, see CDF 
client jobs, X. 25, 122 
client node, name and password, 47, 138 
clock type, 132 
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:co:, 36 

device, 159 
COM ports, 65 
command aliases, 17 
default, 21 

composite objects, 133 
CON device, 12 
config.sys file, 161 
configuration files 
BPS, 144, 145 
dload, 181 
list of, 15 
r?env, 64 
terminals, 24 
user attributes, 22 
configuring 

Adaptec SCSI board, 136 
application jobs, 1 62 
C library, 135, 149 
dispatcher job, 131 
BIOS, 134 

Embedded workstation boards, 123 
HI, 135 

iRMXBIOS, 132 

iRMX-NET, 138, 140 

keyboard, 135 

MIP, 139 

modem, 32 

msnet.ini, 48 

network, 138, 139, 140 

Nucleus, 128 

OS Extensions, 128 

PCI driver, 136 

protected environment, 34 

static and dynamic terminals, 25 

system jobs, 141 

terminals, static and dynamic, 24 

users, 21 

connection-deletion task priority, 133 

consumer definition file (CDF), 47 

consumer node, name and password, 47, 138 

control characters, 30 

control codes, terminals and AEDIT, 29 

<Ctrl> key, 3 1 

<Ctrl-Alt-Break>, 176 

<Ctrl-Alt-Del> keys, 176 

cursor-movement keys, 29 


D 

d_cons device, 12, 162, 163 
provided by keybd.job, 82 
debug command, 160 
debugging loadable job or driver, 38 
<Del> key, 29 
<DelCh> key, 29 
<DelL> key, 29 
<DelR> key, 29 
device drivers 

debugging, 160 
list of, 57 
loading, 36 
source code for, 55 

Device Information (DINFO) table,, 145 
Device Unit Information Blocks, 57 
devices 

attaching in :config:terminals, 44 
attaching in loadinfo, 44 
directories 

:config:default, 21 
xonfigmdf, 21 
:config:user, 22 
:rmx:demo, 55 
:sd:user, 21 
access rights to, 34 
default, 15 

configuring, 22 
home, 21 

configuring, 22 
object, size for I/O jobs, 134 
root, 34 
sd, 34 
working, 21 
disk drive 

ESDI, 132 
formatting, 94 
SCSI, 91,95 
diskless workstations, 26 
dispatcher job, configuring, 131 
dload command, 60, 143 
error messages, 184 
dload.log file, 184 
dload. mb2 file, 181 
DMA, 130 
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DOS 

file driver buffer size, 134 
interrupt request, 58 
task priority, 23 
<Down-Arrow> key, 29 
drivers, see device drivers 
82530 terminal, 69 
atcsdrv, 181 
comdrv, 65 
console, 169 
Ipdrv, 84 
pcidrv, 91 
pcxdrv, 97 
pttydrv, 102 
ramdrv, 68, 104 
source code, 55 
tccdrv, 117 
unloading, 37 
DUIB names 

82530 ports, 69 
ATCS, 61, 144, 192, 193 
COM ports, 65 
console device, 83 
Digiboard terminal controller, 97 
DOS file driver, 68 
HOSTESS terminal controller, 71 
LPT ports, 84 
Multibus I TCC, 118 
PCI, 92,93 
pseudo-terminals, 102 
RAM disk, 104 
dynamic terminals, 16, 162 
configuring, 25 
effects of configuration, 24 


editing configuration files, 13 
EDOS file driver 
buffer size, 134 
priority of, 133 
BIOS 

buffer size, 134 
configuration, 134 
Embedded workstation boards, 
configuring, 123 


encoded interrupts 
bit values, 117 
list of, 58 

encrypted passwords, 14, 47 
environment variables, 64 
error messages 
dload, 184 
logon, 17 
<Esc> key, 29 
escape sequences, 31 
ESDI, 132 

EtherExprss NICs, 78 
EWENETNIC, 78 
exception handlers, 130 
exit_iojob call, 159 
extended memory manager, 73 

F 

file drivers, loadable, 56 
files 

access rights to, 34 
editing configuration, 13 
ES-IS download, 77, 78 
hidden, 13 

list of configuration, 15 
log 

application creates a, 159 
contents of, 38 
created by job or driver, 38 
Null2 download, 77, 78 
remote access to, 18, 47 
submit, 17 

terminal definition, configuring, 28 
UDE, configuring, 21 
user, 15 

user attributes of, 22 
floating-point, 64 
EPI Server, 151 
Eree Space memory, 131 
front panel interrupt, 151 
function keys, 29 

G 

GDT slots, 128 
getenv function, 64 
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global clock, 16, 132 
Global Descriptor Table, 128 
graphics mode, 169 

H 

HI (Human Interface), initialization, 16, 162 
hidden files, 13 
himem.job file, 73 
himem.sys file, 161 
<Home> key, 29 
HOSTESS terminal controller, 71 
avoiding interrupt conflict, 72 
hot key, switching Multibus II consoles, 198 
Human Interface, see HI 

I 

ic command, 181 
icemb2.job, 139 

ICU (Interactive Configuration Utility) 
and modems, 32 
description of, 1 1 
ICU screens 

ATCJ, 191, 196, 197 

CUB, 149 

DLJ, 150 

PC, 153 

FS, 153 

HI, 18 

1279, 196, 197 
1410, 196 
ICMPJ, 152 

IDEVS, 18, 66, 105, 144 

lOUS, 148 

IRAM, 105 

MEMS, 151 

MIPJ, 152 

NCOM, 202 

NET, 152, 153 

NUC, 148 

REM, 153 

RES, 18 

RSJ, 153 

SDM, 192 

SUB, 149 

SYSJ, 141 


U410, 196 
UG279, 196 
URAM, 105 
UT279, 196, 197 
ICU-configurable jobs, 141 
ATCS/279/ARC, 189 
ATCS/450, 199 
Bootserver, 147 
C library, 149 
downloader, 150 
FPI Server, 151 
iNA 960 network, 152 
iRMX-NET, 153 
PCI Server, 155 
Soft-Scope kernel, 156 
TCP/IP, 157 

X.25 client and server, 158 
iNA 960, download filenames, 139 
initial program 

configuring, 22 
starting an application as, 162 
initialization errors for MSA Bootserver, 148 
initrsd file, 135 
initrsd2 file, 135 
input control characters, 3 1 
Interactive Configuration Utility, see ICU 
interactive jobs, memory pool size, 22 
interface library, C, 149 
interrupt handlers, 160 
interrupt virtualization, 131 
interrupts 

COM port, 65 
list of encoded, 58 
on PCL2(A) board, 79 
on TCC board, 117 
IRQ values 

and iRMX interrupts, 58 
list of, 58 
ISO transport, 46 

J 

jobs, 141 

ATCS/279/ARC, 189 
ATCS/450, 199 
atcs279.job, 59 
background, 160 
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bootserv.job, 63 
bootserver, 63, 147 
C library, 64, 149 
clib.job, 64 
COMMputer, 152 
DDE support, 121 
debugger kernel, 114 
debugger loader job, 116 
debugging, 160 
downloader, 143, 150, 181 
front panel interrupt, 151 
himem.job, 73, 113 
i*.job, 44, 46, 75, 86 
i386sx?.job, 78 
i486133?.job, 78 
i486hid?.job, 78 
i552a.job, 77 
icemb2.job, 77 
iethxp?.job, 78 
iewexp?.job, 78 
imix560?.job, 78 
iNA960, 152 
inl*n.job, 46 
inlatn.job, 79 
inlmbln.job, 79 
inlmb2n.job, 79 
interactive, 22 
ipcl2.job, 77 
iRMX-NET, 46, 153 
iRMX-NET server. 111 
isbx586?.job, 78 
itcpkern.job, 80 
keybd.job, 82 
loadable 

ARC server, 59 
atcs279, 59 
bootserver, 63 
debugging, 160 
list of, 56 
loading, 36 
MIP, 44, 77, 152 
netrdr.job, 86 

network, 44, 75, 79, 86, 111 
choosing, 44 

loading controller board, 46 
network redirector, 86 
Null Data Link, 46, 79 


PCI, 155 
PCI Server, 95 
posix.job, 80, lOI 
remote boot server, 107 
rls.job, 109 
sdb.job, 1 12 
smw.job, 113 
Soft-Scope kernel, 156 
standard-mode Windows, 113 
system debugger, 112 
TCP/IP, 157 
unloading, 37 
X.25, 158 
X.25 client, 122 
1ST timeout parameter, 37 
jumpers 

on HOSTESS board, 72 
on PCL2(A) board, 79 

K 

Kernel Tick Ratio, 129 
keyboard 

configuration, 135 
extended functions, 176 
support, 169 

L 

<Left-Arrow> key, 29 
line-editing keys, 29 
loadable device drivers 
debugging, 160 
list of, 57 
loadable jobs, 63 
loadinfo file, 11,15,35,44 
and HI initialization, 16 
example of, 39 
starting an application in, 162 
loadinfo.log file, 16 
load-time parameters 
ADP, 132 
ADV, 134 
AED, 134 
BASEADDR, 137 
BOFET, 137 
BONT, 137 
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BT, 136 
BUS, 129 
BXS, 138 
CBI, 139, 140 
CBN, 139, 140 
CCBS, 137 
CMS, 132 
CNN, 138 
CNP, 138 
CON, 133 
DBS, 134 
DDS, 134 
DEH, 130 
DIB, 130 
DMA, 137 
DN, 139 

DOB, 130 

DOC, 136 
DTP, 133 
EBS, 134 
EFLC, 133 
ENE, 133 
EPR, 132 
ETP, 133 
FN, 139 
GC, 132 
HABASE, 137 
INTL, 138 
JST, 135 
KTR, 129 
LD, 139 

LMl, HMl through LM5, HM5, 131 

LUNOONLY, 136 

MBD, 136 

MBS, 135 

NAR, 130 

NBS, 134 

NEB, 135 

NTP, 133 

OSX, 128 

PBS, 134 

PMS, 132 

RBS, 134 

RDA, 136 

RES SCSI, 138 

RRP, 128 

RRT, 129 


RTP, 133 

SBS, 134 

SBT, 136 
SCF, 135 

SCSICONTYPE, 137 
SCSIID, 138 
SIN, 138 
STO, 137 
TCP, 135 
TE, 135 
TTP, 133 
UML, 128 
VIE, 13 1 
local clock, 132 
logging off, 17 

logical_attach_device call, 147 
logoff command file, 17 
logon command file, 17 
LP486, 78 

M 

memory 

excluding from system, 130 
Free Space, 131 

limiting iRMX use of, 128, 130, 131 
usedbyiRMX, 128,130,131 
used by Windows, 73,113 
memory pools 

size for job or driver, 36 
size for user job, 22 
message passing, 130, 202 
MIX 450 terminal controller, 61, 143, 200 
MIX 560, 78 
MIX 560 NIC, 77,78 
MIX x86/020(A), 78 
modcdf command, 14,138 
modem 

configuring driver for, 32 
setting up, 33 

MPI 450 terminal controller, 61, 143, 200 
MSA, 189 

MSA Bootserver, supported functions, 147 
msnet.ini file, configuring, 48 
Multibus II subnet, 78 
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Multibus I 
PCI, 155 

serial controller boards, 117 
Multibus II 

ATCS, 141 
bootserver, 63, 141 
downloader, 150, 181 
error messages, 184 
front panel interrupt, 151 
MIPjob, 77 
NICs, 77,78 
PCI, 91,95, 155 
terminal configuration, 27 
Multibus II Systems Architecture (MSA), 141 
multitask address 

remote boot server, 107 

N 

named file driver, 14 
buffer size, 134 
priority of, 133 

NCB (Network Control Block), 86 
NetBIOS, 86 

network configuration, 138, 139, 140 

Network Control Block (NCB), 86 

network names, in terminal configuration, 26 

Network Redirector, 86 

NIC (Network Interface Card), list of, 77 

NICs, 78 

Nucleus configuration, 128 

o 

OC/X terminal controller, 97 

OMF type, and dload command, 1 82 

OS extensions, 128 

OSI Reference Model, 46 

output control characters, 3 1 

P 

parallel ports, 84 

avoiding interrupt conflict, 72 
password, encrypting, 21 
password command, 14, 21 
adding users, 21 
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PCI driver configuration, 136 
PCI Server, 91, 94, 95, 155 
and 16 MB limit, 96 
PCL2(A) board jumpers, 79 
PCL2(A)NIC, 77 
pcnet.exe, 86 
pcnet.exe file, 86 

Peripheral Controller Interface, see 
PCI, 91,95 

physical file driver, buffer size, 134 
PIC, 58, 117 
printer ports, 84 
priority 

application job, 160 
attach-device task, 132 
configuring round-robin, 128 
connection-deletion task, 133 
DOS command, 23 
EDOS file driver, 133 
iRMX command, 23 
named file driver, 133 
remote file driver, 133 
static terminal, 25 
timer task, 133 
user job, 22 

programmable interrupt controller, 58 
protected environment, 34 
psh command, 101 
putenv function, 64 

R 

r?env file, 64 
r?init file, 15,35 

and HI initialization, 16 
starting application in, 162 
r?init2file, 15,80 
r?logofffile, 17,21 
r?logon file, 21 
default, 21 

starting an application in, 162 
RAM disk, 68, 104 

creating multiple, 105 
data image in, 104 
RCI protocol, 189 
real time fence, 128 
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remote boot server, 107 
multicast address, 107 
Remote File Driver (RFD), 108 
buffer size, 134 
priority of, 133 
resident/recovery user, 18 
<Right-Arrow> key, 29 
rmx.ini file, 11, 15, 19, 24, 123 
entries in, 125 
example of, 125 
syntax of, 125 
ROM BIOS, 128 
round-robin priority, 128 
routers, 78 

rq_a_get_directory_entry call, 133 
rq_a_special call, 32 
rq_exit_ioJob call, 159 
rq_hscf BPS Parameter, 35 
rq_hterm BPS parameter, 24 
rq_logical_attach_device call, 147 
rq_set_max_priority call, 160 
<Rubout> key, 29, 3 1 

s 

SBC 186/530, 77 

SBC386/SX, 78 

SBC 386SX, 118 

SBC486/133SE, 78 

SBC 486/1 66SE, 78 

SBC486DXss, 78 

SBC552A, 77 

SBCP5090, 78 

SBC PCP4 board, 130 

SBX 279 A, ATCS window for, 190, 193 

SBX586, 78 

scan codes, 171 

SCF parameter, 35 

screen buffer, 163 

screen-saver, 82 

<Scroll Lock>, 176 

SCSI controller, 91,95 

SDB, 112 

security 

file and device access, 34 
remote access, 47 

service information, inside back cover 


set_max_priority call, 160 
shell, 101 

shutdown command, 176 
shutdown script, 80 
smartdrv.exe file, 161 
Soft-Scope, 112 

kernel, 114,116,156 
SPS parameters 

for ATCS, 144, 145 
for MSA Bootserver, 63, 148 
sskernel, 114 
ssload, 116 

standard input and output, 36 
standard-granularity diskettes, 93 
startup script, 80 
static terminals, 16, 162, 163 
configuring, 25 
effects of configuration, 24 
priority of, 25 
static user, 162, 163 
stream file driver, buffer size, 134 
submit command 
HI, 17 

lowering user priority, 23 
subnets, in COMMputer jobs, 78 
super command, 14 
Super user 

configuring files as, 14 
job priority, 22 
password of, 14 
rights of, 14 
sysload 

-r (reload) switch, 38 
-u (unload) switch, 37 
-w (wait) switch, 37 
sysload command, 36,80, 101 
and application jobs, 159 
in loadinfo file, 39 
on command line, 38 
syntax of, 36 

system administrator, see Super user 
system debugger, 112 
system device, 34 

for network download files, 139 
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T 

TCC terminal driver, 117 
TCP parameter, 24 
TCP/IP 

configuration, 157 
kernel job, 80 
starting and stopping, 80 
tcpstart.csd file, 80 
tcpstop.csd file, 80 
termcap file, 15, 28 
entries in, 28 
example of, 30 
terminal controller, 59 
terminal devices 
loading, 44 
unlocking, 44 

terminal file, and HI initialization, 16 
Terminal Support Code, 30 
terminal types 
1510E, 28 
1510T, 28 
ADM3A, 28 
ANY, 28 
AT386, 28 
PC, 28 
QVT102, 28 
RGI, 28 
SI 20, 28 
TV910P, 28 
TV950, 28 
VTIOO, 28 
VT102, 28 
VT52, 28 
WYSE50, 28 
Zentec, 28 
terminals 

configuration file, 24 
configuring, 24 
configuring dynamic, 25 
configuring static, 25 
control codes for, 29 
definition file, 28 
effects of configuration, 24 
initializing remote, 26 
Multibus II, 27 
scrolling mode, 30 


type definition example, 30 
unlocking, 44 

terminals file, 15, 24, 25, 163 
entries in, 25 
example of, 44 
unlocking terminals in, 44 
terminals files 
entries in, 26 
example of, 27 
timer task priority, 133 
TSC, 30 

escape sequences, 31 
type-ahead, 30 

u 

UDF (User Definition File), 21 

udffile, 15,21 

UMB memory, 73 

UML parameter, 96 

Unit Information (UINFO) table, 32 

unloading jobs, 37 

unlock command, 44 

<Up-Arrow> key, 29 

upper memory limit, 128,130,131 

user 

adding, 21 
attributes file, 22 
configuring, 22 
definition file, 21 
deleting, 21,22 
home directory, 21 
job priority for, 23 
resident/recovery, 18 
setting job priority, 22 
static, 25 
verified, 18 
user definition file, 21 
user/<usemame> file, 22 
user/world/prog file, 21 

V 

verified user, 18 
video support, 169 
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w 


wterm program, 163 


win. ini file, 163 
windows 

adding to ATCS 279 server, 195 
automatically starting, 163 
memory used by, 73, 113 
World user 

default priority of, 22 
file access by, 34 


X 


X.25 client, 158 
X.25 server, 158 
XLHM, 130 
XLLM, 130 

XMS services, list of, 73 
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Vancouver V6C 3E2 

British Columbia 

Intel Semiconductor of Canada, Ltd. 

2650 Queensview Drive 

Suite 250 

Ottawa K2B 8FI6 

Ontario 

Intel Semiconductor of Canada, Ltd. 

1 90 Attwell Drive 
Suite 500 
Rexdale MOW 6FI8 
Ontario 

Intel Semiconductor of Canada, Ltd. 

1 Rue Floliday 
Suite 115 
Tour East 
Pt. Claire H9R 5N3 
Ouebec 


CHINA/HONG KONG 

Intel PRC Corporation 
China World Tower, Room 517-518 
1 Jian Guo Men Wai Avenue 
Beijing, 100004 
Republic of China 

Intel Semiconductor Ltd. 

32/F Two Pacific Place 
88 Queensway 
Central 
Flong Kong 

FINLAND 

Intel Finland OY 
Ruosilantie 2 
00390 Flelsinki 

FRANCE 

Intel Corporation S.A.R.L. 

1 , Rue Edison-BP 303 
78054 St. Quentin-en-Yvelines 
Cedex 

GERMANY 

Intel GmbH 

Dornacher Strasse 1 

85622 FeIdkirchen bei Muenchen 

Germany 

INDIA 

Intel Asia Electronics, Inc. 

4/2, Samrah Plaza 
St. Mark's Road 
Bangalore 560001 

ISRAEL 

Intel Semiconductor Ltd. 

Atidim Industrial Park-Neve Sharet 
P.O. Box 43202 
Tel-Aviv 61430 

ITALY 

Intel Corporation Italia S.p.A. 
Milanofiori Palazzo E 
20094 Assago 
Milano 



JAPAN 

Intel Japan K.K. 

5-6 Tokodai, Tsukuba-shi 
Ibaraki, 300-26 

Intel Japan K.K. 

Hachioji ON Bldg. 

4-7-14 Myojin-machi 
Hachioji-shi, Tokyo 192 

Intel Japan K.K. 

Bldg. Kumagaya 
2-69 Hon-cho 

Kumagaya-shi, Saitama 360 

Intel Japan K.K. 

Kawa-asa Bldg. 

2-1 1 -5 Shin-Yokohama 
Kohoku-ku, Yokohama-shi 
Kanagawa, 222 

Intel Japan K.K. 

Ryokuchi-Eki Bldg. 

2-4-1 Terauchi 
Toyonaka-shi, Osaka 560 

Intel Japan K.K. 

Shinmaru Bldg. 

1-5-1 Marunouchi 
Chiyoda-ku, Tokyo 100 

Intel Japan K.K. 

Green Bldg. 

1-16-20 Nishiki 
Naka-ku, Nagoya-shi 
Aichi 460 

KOREA 

Intel Korea, Ltd. 

16th Floor, Life Bldg. 

61 Yoido-dong, Youngdeungpo- 
Ku 

Seoul 150-010 


MEXICO 

Intel Technologica do Mexico 
S.A. de C.V. 

Av. Mexico No. 2798-9B, S.H. 
44620 Guadalajara, Jal., 

NETHERLANDS 

Intel Semiconductor B.V. 
Postbus 84130 
3009 CC Rotterdam 

RUSSIA 

Intel Technologies, Inc. 
Kremenchugskaya 6/7 
121357 Moscow 

SINGAPORE 

Intel Singapore Technology, Ltd. 
101 Thomson Road #08-03/06 
United Square 
Singapore 1130 

SPAIN 

Intel Iberia S.A. 

Zurbaran, 28 
28010 Madrid 

SWEDEN 

Intel Sweden A.B. 

Dalvagen 24 
171 36 Solna 

TAIWAN 

Intel Technology Far East Ltd. 
Taiwan Branch Office 
8th Floor, No. 205 
Bank Tower Bldg. 

Tung Hua N. Road 
Taipei 

UNITED KINGDOM 

Intel Corporation (U.K.) Ltd. 
Pipers Way 

Swindon, Wiltshire SN3 1 RJ 



If you need to contact Intel Customer Support 

Contacting us is easy. Be sure that you have the following information available: 

• Your phone and FAX numbers ready • Your product’s product code 

• Complete description of your hardware • Current version of all software you use 

or software configuration(s) • Complete problem description 

Type of Service 


How to contact us 

FaxBACK* 

fax-on-demand system 

24 hrs a day, 7 days a week 

Using any touch-tone phone, 
have technical documents sent to 
your fax machine. Know your 
fax number before calling. 

U.S. and Canada: (800) 628-2283 
(916) 356-3105 

Europe: +44-1793-496646 

Intel PC and LAN 
Enhancement Support 
BBS 

24 hrs a day, 7 days a week 

Information on products, 
documentation, software drivers, 
firmware upgrades, tools, 
presentations, troubleshooting. 

U.S and Canada: (503) 264-7999 

Europe: -1-44-1793-432955 

Autobaud detect 
8 data bits, no parity, 1 stop 

CompuServe* 
Information Service 

24 hrs a day, 7 days a week 

Worldwide customer support: 
information and technical 
support for designers, engineers, 
and users of 32-bit iRMX® OS 
and Multibus product families. 

Worldwide Locations: 

(check your local listing) 

Type: GO INTELC once online. 

Customer Support 

Intel Multibus Support engineers 
offering technical advice and 
troubleshooting information on 
the latest Multibus products. 

U.S. and Canada: (800) 257-5404 
(503) 696-5025 
EAX: (503) 681-8497 
Hrs: M-E; 8-5 PST 
Europe: +44-1793-641469 

EAX: h- 44-1793-496385 
Hrs: M-E; 9-5:30 GMT 

Hardware Repair 

Multibus board and system 
repair. 

U.S. and Canada: (800) 628-8686 
(602) 554-4904 
EAX: (602) 554-6653 
Hrs: M-E; 7-5 PST 

Europe: h-44-1793-403520 

EAX: h- 44-1793-496156 
Hrs: M-E; 9-5:30 GMT 

Sales 

Intel Sales engineers offering 
information on the latest iRMX 
and Multibus products and their 
availability. 

Worldwide: Contact your local Intel 
office or distributor 
U.S. and Canada: (800) 438-4769 
(503) 696-5025 
EAX: (503) 681-8497 
Hrs: M-E; 8-5 PST 

Correspondence 

Mail letters to: 

Worldwide: 

Intel Customer Support 
Mailstop HF3-55 
5200 NE Elam Young Parkway 
Hillsboro, Oregon 97124-6497 

Europe: 

European Application Support 
Intel Corporation (UK) Ltd. 
Pipers Way 
Swindon, Wiltshire 
England SN3 IRJ 


* Third-party trademarks are the property of their respective owners. 




